Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] Описание класса QFontDialog
^{[модуль QtGui ]}

Виджет диалога для выбора текста Далее...

 #include <QFontDialog>

Наследует QDialog.

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

[править] Статические открытые члены

• QFont getFont ( bool * ok, const QFont & initial, QWidget * parent, const QString & caption )
• QFont getFont ( bool * ok, const QFont & def, QWidget * parent, const char * name )
• QFont getFont ( bool * ok, QWidget * parent, const char * name )
• QFont getFont ( bool * ok, const QFont & initial, QWidget * parent = 0 )
• QFont getFont ( bool * ok, QWidget * parent = 0 )

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

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

• 2 войства, унаследованные от QDialog
• 56 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject
• 5 открытых функций, унаследованных от QDialog
• 201 свойство, унаследованное от QWidget
• 29 открытых функций, унаследованных от QObject
• 12 открытых функций, унаследованных от QPaintDevice
• 4 открытых слота, унаследованные от QDialog
• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 3 сигнала, унаследованные от QDialog
• 1 сигнал, унаследованный от QWidget
• 1 сигнал, унаследованный от QObject
• 38 защищенных функций, унаследованных от QWidget
• 7 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованных от QPaintDevice
• 1 защищенный слот, унаследованый от QWidget

[править] Подробное описание

Виджет диалога для выбора текста

Обычный способ использования данного класса состоит в вызове одной из удобных статических функций, например, 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, то виджетом будет использоваться исходный шрифт.

Файл:Plastique-fontdialog.png

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

[править] Описание функций-членов

[править]

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

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

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

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

Данная статическая функция менее гибкая, чем полноценный объект QFontDialog, но она удобна и проста в использовании..

Примеры:

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

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

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

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

[править]

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

Эта перегруженная функция предоставлена для удобства.

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

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

[править]

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

Эта перегруженная функция предоставлена для удобства.

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

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

[править]

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 не является нулевым указателем, то *ok устанавливается в true, если пользователь нажимает кнопку OK, и в false, если пользователь нажимает кнопку Cancel.

Данная статическая функция менее гибкая, чем полноценный объект QFontDialog, но она удобна и проста в использовании.

Пример:

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