QFontDialog - Dialog widget for selecting a text font
#include <qfontdialog.h>
Inherits QDialog.
Signals
void fontSelected ( const QFont & font )
void fontHighlighted ( const QFont & font )
Static Public Members
QFont getFont ( bool * ok, const QFont & def, QWidget *
parent = 0, const char * name = 0 )
QFont getFont ( bool * ok, QWidget * parent = 0, const
char * name = 0 )
Protected Members
virtual bool eventFilter ( QObject *, QEvent * )
QListBox* familyListBox () const
virtual void updateFamilies ()
QListBox* styleListBox () const
virtual void updateStyles ()
QListBox* sizeListBox () const
virtual void updateSizes ()
QComboBox* scriptCombo () const
virtual void updateScripts ()
Protected Slots
void sizeChanged ( const QString & )
DESCRIPTION
The QFontDialog class provides a dialog widget for
selecting a text font.
This dialog can be used to let the user choose a font with
attributes and so on. Normally you may use the static
convenience function getFont().
[Image Omitted]
[Image Omitted]
bool QFontDialog::eventFilter ( QObject * o, QEvent * e )
[virtual protected]
Event filter to make up, down, pageup and pagedown work
correctly in the line edits.
Reimplemented from QObject.
QListBox * QFontDialog::familyListBox () const [protected]
Returns a pointer to the "font family" list box. This is
usable mainly if you reimplement updateFontFamilies();.
void QFontDialog::fontHighlighted ( const QFont & ) [signal]
This signal is emitted, when the user changed a setting in
the dialog.
void QFontDialog::fontSelected ( const QFont & ) [signal]
This signal is emitted, when the user has chosen a font
and clicked ok.
QFont QFontDialog::getFont ( bool * ok, QWidget * parent =
0,const char * name = 0 ) [static]
Opens a modal font dialog and returns the font selected by
the user.
The ok parameter is set to TRUE if the user clicked OK,
and FALSE if the user clicked Cancel.
If the user clicks Cancel the Qt default font is returned.
This static function is less capable than the full
QFontDialog object, but is convenient and easy to use.
Example:
// start at the current working directory and with *.cpp as filter
bool ok;
QFont f = QFontDialog::getFont( &ok, this );
if ( ok ) {
// the user selected a valid font
} else {
// the user cancelled the dialog
}
QFont QFontDialog::getFont ( bool * ok, const QFont & initial,
QWidget * parent = 0, const char * name = 0 ) [static]
Opens a modal font dialog and returns the font selected by
the user.
initial is the initial selected font.
The ok parameter is set to TRUE if the user clicked OK,
and FALSE if the user clicked Cancel.
This static function is less capable than the full
QFontDialog object, but is convenient and easy to use.
Example:
// start at the current working directory and with *.cpp as filter
bool ok;
QFont f = QFontDialog::getFont( &ok, QFont( "Times", 12 ), this );
if ( ok ) {
// the user selected a valid font
} else {
// the user cancelled the dialog
}
Another example:
mywidget.setFont( QFontDialog::getFont( 0, mywidget.font() ) );
QComboBox * QFontDialog::scriptCombo () const [protected]
Returns a pointer to the "font style" list box. This is
usable mainly if you reimplement updateFontStyles();.
void QFontDialog::sizeChanged ( const QString & s ) [protected
slot]
This slot is called if the user changes the font size.
QListBox * QFontDialog::sizeListBox () const [protected]
Returns a pointer to the "font size" list box. This is
usable mainly if you reimplement updateFontSizes();.
QListBox * QFontDialog::styleListBox () const [protected]
Returns a pointer to the "font style" list box. This is
usable mainly if you reimplement updateFontStyles();.
void QFontDialog::updateFamilies () [virtual protected]
Update the contents of the "font family" list box. This
function can be reimplemented if you have special
requirements.
void QFontDialog::updateScripts () [virtual protected]
Update the contents of the "font script" combo box. This
function can be reimplemented if you have special
requirements.
void QFontDialog::updateSizes () [virtual protected]
Update the contents of the "font size" list box. This
function can be reimplemented if you have special
requirements.
void QFontDialog::updateStyles () [virtual protected]
Update the contents of the "font style" list box. This
function can be reimplemented if you have special
SEE ALSO
http://doc.trolltech.com/qfontdialog.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page
(qfontdialog.3qt) and the Qt version (2.3.1).
Man(1) output converted with
man2html