Класс QFontDialog

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

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

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

Свойства

• currentFont : QFont
• options : FontDialogOptions

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

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

Реализованные функции публичного доступа

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

Сигналы

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

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

• 5 статических членов публичного доступа унаследованы от QWidget
• 11 статических членов публичного доступа унаследованы от 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 = Q_NULLPTR)

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

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

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

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

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

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

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

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

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

[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 = Q_NULLPTR, const QString &title = QString(), 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 = Q_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.

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

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

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

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

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

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

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

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

bool QFontDialog::testOption(FontDialogOption option) const

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

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