Класс QFontDialog

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

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

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

Свойства

• currentFont : QFont
• options : FontDialogOptions

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

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

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

• 8 открытых функций унаследовано от QDialog
• 214 открытых функций унаследовано от QWidget
• 31 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Сигналы

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

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

• 5 статических открытых членов унаследовано от QWidget
• 9 статических открытых членов унаследовано от QObject

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

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

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

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

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

Класс 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 не равен 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 QFontDialog::testOption(QFontDialog::FontDialogOption option) const

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

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