Класс QFontDialog

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

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

Открытые типы

Свойства

• currentFont : QFont
• options : FontDialogOptions

Открытые функции

Переопределённые открытые функции

Сигналы

Статические открытые члены

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

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

Диалоговое окно шрифта создается с помощью одной из статических функций 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 — это typedef для QFlags<FontDialogOption>. Он хранит логическое ИЛИ комбинацию значений FontDialogOption.

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

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

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

Конструирует стандартное диалоговое окно шрифтов с заданным parent и указанным начальным шрифтом initial.

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

QFontDialog::QFontDialog(QWidget *parent = nullptr)

Конструирует стандартное диалоговое окно шрифтов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Переопределяет: QWidget::changeEvent(QEvent *event).

QFont QFontDialog::currentFont() const

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

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

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

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

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

Переопределяет: QDialog::done(int r).

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

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

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

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

Если пользователь нажмёт ОК, возвращается выбранный шрифт. Если пользователь нажмёт Отмена, возвращается шрифт 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)

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

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

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

Диалоговое окно создаётся с заданным 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.

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

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

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

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

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

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

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

Переопределяет: QDialog::setVisible(bool visible).

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

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

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