Класс QFontDialog

Класс QFontDialog предоставляет виджет диалога для выбора шрифта. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Свойства

• currentFont : QFont
• options : FontDialogOptions

• 2 свойства унаследованы от QDialog
• 59 свойств унаследованы от QWidget
• 1 свойство унаследовано от QObject

Функции публичного доступа

Переопределенные функции публичного доступа

• 8 функций публичного доступа унаследовано от QDialog
• 214 функций публичного доступа унаследовано от QWidget
• 34 функции публичного доступа унаследовано от QObject
• 14 функций публичного доступа унаследовано от QPaintDevice

Сигналы

• 3 сигнала унаследовано от QDialog
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические члены публичного доступа

• 5 статических членов публичного доступа унаследовано от QWidget
• 10 статических членов публичного доступа унаследовано от QObject

Переопределенные защищенные функции

• 6 защищенных функций унаследовано от QDialog
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 5 публичных слотов унаследовано от QDialog
• 19 публичных слотов унаследовано от QWidget
• 1 публичный слот унаследовано от QObject
• 1 публичная переменная унаследовано от QObject
• 6 защищенных функций унаследовано от QDialog
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice
• 1 защищенный слот унаследовано от QWidget
• 2 защищенных переменных унаследовано от QObject
• 1 защищенный тип унаследовано от QPaintDevice

Подробное описание

Класс QFontDialog предоставляет виджет диалога для выбора шрифта.

Диалог шрифта создается с помощью одной из статических функций getFont().

Примеры:

bool ok;
QFont font = QFontDialog::getFont(
                &ok, QFont("Helvetica [Cronyx]", 10), this);
if (ok) {
    // the user clicked OK and font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Helvetica [Cronyx], 10
}

Диалог также можно использовать для непосредственного задания шрифта виджета:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

Если пользователь нажмет «ОК», выбранный шрифт будет использован для myWidget, а если «Отмена» — используется исходный шрифт.

См. также QFont, QFontInfo, QFontMetrics, QColorDialog, QFileDialog и Пример стандартных диалогов.

Документация по типам членов

перечисление QFontDialog::FontDialogOptionфлаги QFontDialog::FontDialogOptions

Это перечисление задает различные параметры, влияющие на внешний вид диалога выбора шрифта.

Например, оно позволяет указать, какой тип шрифта следует отображать. Если параметры не указаны, будут отображаться все доступные шрифты.

Обратите внимание, что параметры фильтрации шрифтов могут не поддерживаться на некоторых платформах (например, Mac). Они всегда поддерживаются неродным диалогом (используемым в Windows или Linux).

Это перечисление было введено или изменено в Qt 4.5.

Тип FontDialogOptions — это тип-синоним для QFlags<FontDialogOption>. Он хранит логическое ИЛИ сочетание значений FontDialogOption.

См. также options, setOption() и testOption().

Документация по членам-функциям

QFontDialog::QFontDialog(QWidget *parent = nullptr)

Создаёт стандартный диалог выбора шрифта.

Используйте setCurrentFont(), чтобы установить начальные атрибуты шрифта.

Параметр parent передаётся конструктору QDialog.

Эта функция была введена в Qt 4.5.

См. также getFont().

QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

Создаёт стандартный диалог выбора шрифта с заданным parent и указанным начальным шрифтом initial.

Эта функция была введена в Qt 4.5.

[override virtual protected] void QFontDialog::changeEvent(QEvent *e)

Переопределено из QWidget::changeEvent().

QFont QFontDialog::currentFont() const

Возвращает текущий шрифт.

Эта функция была введена в Qt 4.5.

Примечание: Функция-геттер для свойства currentFont.

См. также setCurrentFont() и selectedFont().

[signal] void QFontDialog::currentFontChanged(const QFont &font)

Этот сигнал излучается при изменении текущего шрифта. Новый шрифт указан в font.

Сигнал излучается, когда пользователь выбирает шрифт. В конечном итоге выбранный шрифт может отличаться от текущего выбранного.

Эта функция была введена в Qt 4.5.

Примечание: Сигнал-уведомление для свойства currentFont.

См. также currentFont, fontSelected() и selectedFont().

[override virtual protected] void QFontDialog::done(int result)

Переопределено из QDialog::done().

Закрывает диалог и устанавливает его код результата в result. Если этот диалог показан с помощью exec(), done() завершает локальный цикл событий и exec() возвращает result.

См. также QDialog::done().

[signal] void QFontDialog::fontSelected(const QFont &font)

Этот сигнал излучается, когда шрифт был выбран. Выбранный шрифт указан в font.

Сигнал излучается только тогда, когда пользователь выбрал окончательный шрифт. Он не излучается, когда пользователь изменяет текущий шрифт в диалоге выбора шрифта.

Эта функция была введена в Qt 4.5.

См. также selectedFont(), currentFontChanged() и currentFont.

[static] QFont QFontDialog::getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = ...)

Выполняет модальный диалог выбора шрифта и возвращает шрифт.

Если пользователь нажимает ОК, возвращается выбранный шрифт. Если пользователь нажимает Отмена, возвращается шрифт initial.

Диалог создаётся с заданным parent и параметрами, указанными в options. title отображается как заголовок окна диалога, а initial — как первоначально выбранный шрифт. Если параметр ok не равен нулю, значение, на которое он ссылается, устанавливается в true, если пользователь нажимает ОК, и в false, если пользователь нажимает Отмена.

Примеры:

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Times, 12.
}

Диалог также может использоваться для непосредственной установки шрифта виджета:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

В этом примере, если пользователь нажмёт ОК, будет использован выбранный ими шрифт, а если Отмена — исходный шрифт.

Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы хотите это сделать, вы должны создать диалог самостоятельно, используя один из конструкторов QFontDialog.

[static] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr)

Это перегруженная функция.

Выполняет модальный диалог выбора шрифта и возвращает шрифт.

Если пользователь нажимает ОК, возвращается выбранный шрифт. Если пользователь нажимает Отмена, возвращается системный шрифт по умолчанию.

Диалог создаётся с заданным parent. Если параметр ok не равен нулю, его значение устанавливается в true, если пользователь нажимает ОК, и в false, если пользователь нажимает Отмена.

Пример:

bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the default
    // application font, QApplication::font()
}

Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы хотите это сделать, вы должны создать диалог самостоятельно, используя один из конструкторов QFontDialog.

void QFontDialog::open(QObject *receiver, const char *member)

Это перегруженная функция.

Открывает диалог и подключает его сигнал fontSelected() к слоту, указанному receiver и member.

Сигнал будет отключён от слота при закрытии диалога.

Эта функция была введена в Qt 4.5.

QFont QFontDialog::selectedFont() const

Возвращает шрифт, выбранный пользователем нажатием кнопки ОК или эквивалентной.

Примечание: Этот шрифт не всегда совпадает со шрифтом, хранящимся в свойстве currentFont, так как пользователь может выбирать разные шрифты, прежде чем окончательно выбрать тот, который будет использоваться.

void QFontDialog::setCurrentFont(const QFont &font)

Устанавливает выделенный шрифт в диалоге QFontDialog на заданный font.

Эта функция была введена в Qt 4.5.

Примечание: Функция-сеттер для свойства currentFont.

См. также currentFont() и selectedFont().

void QFontDialog::setOption(QFontDialog::FontDialogOption option, bool on = true)

Устанавливает заданный option в состояние включения, если on равно true; в противном случае очищает заданный option.

См. также options и testOption().

[override virtual] void QFontDialog::setVisible(bool visible)

Переопределено из QDialog::setVisible().

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

Возвращает значение true, если заданный option включен; в противном случае возвращает false.

См. также options и setOption().