Qt:Документация 4.3.2/qfontdialog

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

Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Image:trolltech-logo.png

Содержание

[править] Описание класса 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(
                 &amp;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(&amp;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(&amp;ok, this);
 if (ok) {
     // в качестве шрифта устанавливается шрифт, выбранный пользователем
 } else {
     // пользователь нажимает отменить, шрифт остаётся прежним
     // в качестве шрифта устанавливается шрифт приложения, QApplication::font()
 }

Copyright © 2007 Trolltech Trademarks
Qt 4.3.2