QFontDialog类

QFontDialog类

QFontDialog类提供了可以选择字体的对话框窗口部件。 详情请见……

#include <qfontdialog.h>

继承了QDialog。

所有成员函数的列表。

静态公有成员

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

---

详细描述

QFontDialog类提供了可以选择字体的对话框窗口部件。

使用这个类的常用方法是调用静态函数中的一个，比如，getFont()。

实例：

    bool ok;
    QFont font = QFontDialog::getFont(
                    &ok, QFont( "Helvetica [Cronyx]", 10 ), this );
    if ( ok ) {
        // font被设置为用户选择的字体
    } else {
        // 用户取消这个对话框，font被设置为初始值，在这里就是Helvetica [Cronyx], 10
    }
  

对话框也可以被用来直接设置窗口部件的字体：

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

如果用户点击OK，它们选择的字体将被myWidget使用，并且如果点击Cancel，最初的字体被使用。

也可以参考QFont、QFontInfo、QFontMetrics和对话框类。

---

成员函数文档

QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent = 0, const char * name = 0 ) [静态]

执行一个模式字体对话框并且返回一个字体。

如果用户点击OK，被选择的字体将被返回，并且如果点击Cancel，initial字体被返回。

对话框的父对象为parent、名称为name。initial是初始选择的字体。如果ok参数为非零，则如果用户点击OK，*ok被设置为真，并且如果用户点击Cancel，就被设置为假。

这个静态函数没有完整的QFontDialog对象灵活，但是要方便并且容易使用。

实例：

    bool ok;
    QFont font = QFontDialog::getFont( &ok, QFont( "Times", 12 ), this );
    if ( ok ) {
        // font被设置为用户选择的字体
    } else {
        // 用户取消这个对话框，font被设置为初始值，在这里就是Times, 12
    }
  

对话框也可以被用来直接设置窗口部件的字体：

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

在这个实例中，如果用户点击OK，它们选择的字体将被使用，并且如果点击Cancel，最初的字体被使用。

实例：chart/chartform.cpp、chart/optionsform.cpp、qfd/fontdisplayer.cpp、qwerty/qwerty.cpp和xform/xform.cpp。

QFont QFontDialog::getFont ( bool * ok, QWidget * parent = 0, const char * name = 0 ) [静态]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

执行一个模式字体对话框并且返回一个字体。

如果用户点击OK，被选择的字体将被返回，并且如果点击Cancel，Qt默认字体被返回。

对话框的父对象为parent、名称为name。initial是初始选择的字体。如果ok参数为非零，则如果用户点击OK，*ok被设置为真，并且如果用户点击Cancel，就被设置为假。

这个静态函数没有完整的QFontDialog对象灵活，但是要方便并且容易使用。

实例：

    bool ok;
    QFont font = QFontDialog::getFont( &ok, this );
    if ( ok ) {
        // font被设置为用户选择的字体
    } else {
        // 用户取消这个对话框，font被设置为默认应用程序字体，QApplication::font()
    }