Contents

• Public Types
• Properties
• Public Functions
• Reimplemented Public Functions
• Signals
• Static Public Members
• Reimplemented Protected Functions
• Detailed Description

Detailed Description

TheQFontDialog class provides a dialog widget for selecting a font.

A font dialog is created through one of the staticgetFont() functions.

Examples:

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}

The dialog can also be used to set a widget's font directly:

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

If the user clicks OK the font they chose will be used for myWidget, and if they click Cancel the original font is used.

Member Type Documentation

enum QFontDialog::FontDialogOption
flags QFontDialog::FontDialogOptions

This enum specifies various options that affect the look and feel of a font dialog.

This enum was introduced or modified in Qt 4.5.

The FontDialogOptions type is a typedef forQFlags<FontDialogOption>. It stores an OR combination of FontDialogOption values.

See alsooptions,setOption(), andtestOption().

Property Documentation

currentFont :QFont

This property holds the current font of the dialog.

This property was introduced in Qt 4.5.

Access functions:

Notifier signal:

options :FontDialogOptions

This property holds the various options that affect the look and feel of the dialog.

By default, all options are disabled.

Options should be set before showing the dialog. Setting them while the dialog is visible is not guaranteed to have an immediate effect on the dialog (depending on the option and on the platform).

This property was introduced in Qt 4.5.

Access functions:

See alsosetOption() andtestOption().

Member Function Documentation

QFontDialog::QFontDialog(QWidget * parent = 0)

Constructs a standard font dialog.

UsesetCurrentFont() to set the initial font attributes.

Theparent parameter is passed to theQDialog constructor.

This function was introduced in Qt 4.5.

See alsogetFont().

QFontDialog::QFontDialog(constQFont & initial,QWidget * parent = 0)

Constructs a standard font dialog with the givenparent and specifiedinitial font.

This function was introduced in Qt 4.5.

[virtual protected]void QFontDialog::changeEvent(QEvent * e)

Reimplemented fromQWidget::changeEvent().

[virtual protected]void QFontDialog::done(int result)

Reimplemented fromQDialog::done().

Closes the dialog and sets its result code toresult. If this dialog is shown withexec(), done() causes the local event loop to finish, andexec() to returnresult.

See alsoQDialog::done().

[signal]void QFontDialog::fontSelected(constQFont & font)

This signal is emitted when a font has been selected. The selected font is specified infont.

The signal is only emitted when a user has chosen the final font to be used. It is not emitted while the user is changing the current font in the font dialog.

This function was introduced in Qt 4.5.

See alsoselectedFont(),currentFontChanged(), andcurrentFont.

[static]QFont QFontDialog::getFont(bool * ok, constQFont & initial,QWidget * parent, constQString & title,FontDialogOptions options)

Executes a modal font dialog and returns a font.

If the user clicksOK, the selected font is returned. If the user clicksCancel, theinitial font is returned.

The dialog is constructed with the givenparent and the options specified inoptions.title is shown as the window title of the dialog andinitial is the initially selected font. If theok parameter is not-null, the value it refers to is set to true if the user clicksOK, and set to false if the user clicksCancel.

Examples:

bool ok;QFont font=QFontDialog::getFont(&ok,QFont("Times",12),this);if (ok) {// 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 Times, 12.}

The dialog can also be used to set a widget's font directly:

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

In this example, if the user clicks OK the font they chose will be used, and if they click Cancel the original font is used.

Warning: Do not deleteparent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of theQFontDialog constructors.

[static]QFont QFontDialog::getFont(bool * ok, constQFont & initial,QWidget * parent, constchar * name)

CallgetFont(ok,initial,parent) instead.

Warning: Do not deleteparent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of theQFontDialog constructors.

Thename parameter is ignored.

This function was introduced in Qt 4.5.

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

CallgetFont(ok,parent) instead.

Warning: Do not deleteparent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of theQFontDialog constructors.

Thename parameter is ignored.

[static]QFont QFontDialog::getFont(bool * ok, constQFont & initial,QWidget * parent, constQString & title)

This is an overloaded function.

This function was introduced in Qt 4.5.

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

This is an overloaded function.

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

This is an overloaded function.

Executes a modal font dialog and returns a font.

If the user clicksOK, the selected font is returned. If the user clicksCancel, the Qt default font is returned.

The dialog is constructed with the givenparent. If theok parameter is not-null, the value it refers to is set to true if the user clicksOK, and false if the user clicksCancel.

Example:

bool ok;QFont font=QFontDialog::getFont(&ok,this);if (ok) {// font is set to the font the user selected}else {// the user canceled the dialog; font is set to the default// application font, QApplication::font()}

Warning: Do not deleteparent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of theQFontDialog constructors.

void QFontDialog::open(QObject * receiver, constchar * member)

This is an overloaded function.

Opens the dialog and connects itsfontSelected() signal to the slot specified byreceiver andmember.

The signal will be disconnected from the slot when the dialog is closed.

This function was introduced in Qt 4.5.

QFont QFontDialog::selectedFont() const

Returns the font that the user selected by clicking theOK or equivalent button.

Note:This font is not always the same as the font held by thecurrentFont property since the user can choose different fonts before finally selecting the one to use.

void QFontDialog::setOption(FontDialogOption option,bool on = true)

Sets the givenoption to be enabled ifon is true; otherwise, clears the givenoption.

See alsooptions andtestOption().

[virtual]void QFontDialog::setVisible(bool visible)

Reimplemented fromQWidget::setVisible().

bool QFontDialog::testOption(FontDialogOption option) const

Returns true if the givenoption is enabled; otherwise, returns false.

See alsooptions andsetOption().