Класс 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 является псевдонимом для 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.

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

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

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

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

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

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

Примечание: Функция-получатель для свойства 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()));

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

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

[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()
}

Предупреждение: Не удаляйте 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 visible).

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

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

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