Главная · Все классы · Все функции · Обзоры

Описание класса QFontDialog
[модуль QtGui]

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

 #include <QFontDialog>

Унаследован от QDialog.

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

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

Свойства

• currentFont : QFont
• options : FontDialogOptions

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

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

Вновь реализованные открытые функции

• 8 открытых функций, унаследованных от QDialog
• 217 открытых функций, унаследованных от QWidget
• 29 открытых функций, унаследованных от QObject
• 13 открытых функций, унаследованных от QPaintDevice

Сигналы

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

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

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

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

• 7 защищенных функций, унаследованных от QDialog
• 37 защищенных функций, унаследованных от QWidget
• 7 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice

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

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

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

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

Диалог выбора шрифта создается посредством одной из статических функций getFont().

Примеры:

 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()));

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

Смотрите также QFont, QFontInfo, QFontMetrics, QColorDialog, QFileDialog, QPrintDialog и Standard Dialogs Example.

Описание типов-членов

enum QFontDialog::FontDialogOption
flags QFontDialog::FontDialogOptions

Это перечисление задаёт различные опции, которые касаются внешнего вида и поведения диалога выбора шрифта.

Данное перечисление было введено в Qt 4.5.

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

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

Описание свойств

currentFont : QFont

Это свойство содержит текущий шрифт диалога.

Это свойство было введено в Qt 4.5.

Функции доступа:

Сигнал извещателя (Notifier):

опции : FontDialogOptions

Это свойство содержит различные опции, которые влияют на внешний вид и поведение диалога.

По умолчанию все опции отключены.

Опции должны быть установлены до показа диалога. Их установка пока диалог видим не гарантирует немедленного эффекта на диалоге (зависит от опции и платформы).

Это свойство было введено в Qt 4.5.

Функции доступа:

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

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

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