#include <QFontDialog>

 bool ok;
 QFont font = QFontDialog::getFont(
                 &ok, QFont("Helvetica [Cronyx]", 10), this);
 if (ok) {
     // пользователь нажимает OK, и шрифт устанавливается в выбранный
 } else {
     // пользователь нажимает отменить, шрифт остаётся прежним
     // в данном случае, Helvetica [Cronyx], 10
 }

 myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

Описание функций-членов

QFontDialog::QFontDialog ( QWidget * parent = 0 )

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

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

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

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

Смотрите также getFont().

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

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

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

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

Переопределено от QWidget::changeEvent().

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

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

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

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

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

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

Переопределено из QDialog::done().

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

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

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

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

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

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

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

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

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

Если пользователь нажимает кнопку OK, то возвращается выбранный шрифт. Если пользователь нажимает кнопку Cancel, то возвращается шрифт initial.

Диалог создает с заданным родителем parent и опций, задаваемых в options. title показывает как заголовок окна диалога, а initial - первоначально выбранный шрифт. Если параметр ok не равен нулю, значение, на которое он ссылается, устанавливается равным true, если пользователь щелкнул кнопку OK, и устанавливается равным false, если пользователь щелкнул кнопку Cancel.

Примеры:

 bool ok;
 QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
 if (ok) {
     // устанавливается шрифт, выбранный пользователем
 } else {
     // пользователь нажимает отменить, шрифт остаётся прежним
     // в данном случае, Times, 12.
 }

Диалог также может использоваться для непосредственного задания шрифта виджета:

 myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

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

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

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const char * name ) [static]

Вызывайте взамен getFont(ok, initial, parent).

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

Параметр name игнорируется.

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

QFont QFontDialog::getFont ( bool * ok, QWidget * parent, const char * name ) [static]

Вместо нее можно вызвать функцию getFont(ok, parent).

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

Параметр name игнорируется.

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

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

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

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent = 0 ) [static]

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

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

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

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

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

Диалог создается с родителем parent. Если параметр ok не является нулевым указателем, то его значение устанавливается в true, когда пользователь нажимает кнопку OK, и в false, когда пользователь нажимает кнопку Cancel.

Пример:

 bool ok;
 QFont font = QFontDialog::getFont(&ok, this);
 if (ok) {
     // устанавливается шрифт, выбранный пользователем
 } else {
     // пользователь нажимает отменить, шрифт остаётся прежним
     // в качестве шрифта устанавливается шрифт приложения, QApplication::font()
 }

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

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

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

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

Сигнал будет отсоединен от слота когда диалог закрывается.

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

QFont QFontDialog::selectedFont () const

Возвращает шрифт, которые пользователь выбрал щелкнув по кнопке OK или эквивалентной кнопке.

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

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

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

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

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

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

bool QFontDialog::testOption ( FontDialogOption option ) const

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

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