Класс 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).

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

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

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

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

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

QFontDialog::QFontDialog(QWidget *parent = nullptr)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QFont QFontDialog::currentFont() const

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

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

См. также 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 не равен null, его значение устанавливается в 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()));

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

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

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

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

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

Диалоговое окно создаётся с заданным parent. Если параметр ok не равен null, его значение устанавливается в 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()
}

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

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

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

QFont QFontDialog::selectedFont() const

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

void QFontDialog::setCurrentFont(const QFont &font)

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

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

См. также 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().