Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

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

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

#include <QFontDialog>

Наследует QDialog.

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

Static Public Members

• QFont getFont ( bool * ok, const QFont & initial, QWidget * parent = 0 )
• 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, QWidget * parent = 0 )

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

Дополнительные Унаследованные Члены

• 2 свойства, унаследованные от QDialog
• 54 свойства, унаследованные от QWidget
• 1 свойство, унаследованное от QObject
• 9 открытых функций, унаследованных от QDialog
• 188 открытых функций, унаследованных от QWidget
• 28 открытых функций, унаследованных от QObject
• 10 открытых функций, унаследованных от QPaintDevice
• 5 открытых слотов, унаследованных от QDialog
• 17 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 3 сигнала, унаследованных от QDialog
• 1 сигнал унаследованный от QWidget
• 1 сигнал унаследованный от QObject
• 39 защищенных функций унаследованных от QWidget
• 7 защищенных функций унаследованных от QObject

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

Класс 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()));

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

See also QFont, QFontInfo, and QFontMetrics.

Описание Функций-Членов

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

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

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

Диалог создается с родителем parent. Изначально устанавливается шрифт 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, QWidget * parent = 0 )   [static]

Данная перегруженная функция-член предоставлена для удобства, ее поведение аналогично поведению вышеприведенной функции.

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

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

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

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

Пример:

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