|
|
Dialog for interactive font selection. Provides a wrapper around KFontChooser.
KFontDialog ( QWidget *parent = 0L, const char *name = 0, bool modal = false, bool onlyFixed = false, const QStringList &fontlist = QStringList(), bool makeFrame = true ) |
Constructor. Creates a new font picker dialog.
Parameters:
parent | The parent widget of the dialog, if any. |
name | The name of the dialog. |
modal | Specifies whether the dialog is modal or not. |
onlyFixed | only display fonts which have fixed-width character sizes. |
fontlist | a list of fonts to display, in XLFD format. If no list is formatted, the internal KDE font list is used. If that has not been created, X is queried, and all fonts available on the system are displayed. |
makeFrame | Draws a frame with titles around the contents. |
void setFont ( const QFont &font, bool onlyFixed = false ) |
Sets the currently selected font in the dialog.
Parameters:
font | The font to select. |
onlyFixed | readjust the font list to display only fixed width fonts if true, or vice-versa |
QFont font () |
Returns: The currently selected font in the dialog.
int getFont ( QFont &theFont, bool onlyFixed = false, QWidget *parent = 0L, bool makeFrame = true ) |
This is probably the function you are looking for. Just call this to pop up a dialog to get the selected font.
Parameters:
theFont | a reference to the font to write the chosen font into. |
onlyFixed | if true, only select from fixed-width fonts. |
parent | Parent widget of the dialog. Specifying a widget different from 0 (Null) improves centering (looks better). |
makeFrame | Draws a frame with titles around the contents. |
Returns: The result of the dialog.
int getFontAndText ( QFont &theFont, QString &theString, bool onlyFixed = false, QWidget *parent = 0L, bool makeFrame = true ) |
When you are not only interested in the font selected, but also in the example string typed in, you can call this method.
Parameters:
theFont | a reference to the font to write the chosen font into. |
theString | a reference to the example text that was typed. |
onlyFixed | if true, only select from fixed-width fonts. |
parent | Parent widget of the dialog. Specifying a widget different from 0 (Null) improves centering (looks better). |
makeFrame | Draws a frame with titles around the contents. |
Returns: The result of the dialog.
void fontSelected ( const QFont &font ) |
connect to this to monitor the font as it is selected if you are not running modal.