QFontDatabase(3qt)QFontDatabase(3qt)NAME
QFontDatabase - Provides information about available fonts
#include <qfontdatabase.h>
Public Members
QFontDatabase ()
QStringList families ( bool onlyForLocale = TRUE ) const
QValueList<int> pointSizes ( const QString & family, const
QString & style = QString::null, const QString &
charSet = QString::null )
QStringList styles ( const QString & family, const QString
& charSet = QString::null ) const
QStringList charSets ( const QString & familyName, bool
onlyForLocale = TRUE ) const
QFont font ( const QString familyName, const QString &
style, int pointSize, const QString charSetName =
QString::null )
bool isBitmapScalable ( const QString & family, const
QString & style = QString::null, const QString &
charSet = QString::null ) const
bool isSmoothlyScalable ( const QString & family, const
QString & style = QString::null, const QString &
charSet = QString::null ) const
bool isScalable ( const QString & family, const QString &
style = QString::null, const QString & charSet =
QString::null ) const
bool isFixedPitch ( const QString & family, const QString
& style = QString::null, const QString & charset =
QString::null ) const
QValueList<int> smoothSizes ( const QString & family,
const QString & style, const QString & charSet =
QString::null )
bool italic ( const QString & family, const QString &
style, const QString & charSet = QString::null ) const
bool bold ( const QString & family, const QString & style,
const QString & charSet = QString::null ) const
int weight ( const QString & family, const QString &
style, const QString & charSet = QString::null ) const
QString styleString ( const QFont & )
Static Public Members
QValueList<int> standardSizes ()
QString verboseCharSetName ( const QString & charSetName )
QString charSetSample ( const QString & charSetName )
DESCRIPTION
Provides information about available fonts.
QFontDatabase provides information about the available
fonts of the underlying window system.
Most often you will simply want to query the database for
Trolltech AS 13 June 2001 1
QFontDatabase(3qt)QFontDatabase(3qt)
all font families(), and their respective pointSizes(),
styles() and charSets().
MEMBER FUNCTION DOCUMENTATIONQFontDatabase::QFontDatabase ()
Creates a font database object.
bool QFontDatabase::bold ( const QString & family, const QString
& style, const QString & charSet = QString::null ) const
Returns if the font which matches the settings family,
style and charSet is bold or not.
See also italic() and weight().
QString QFontDatabase::charSetSample ( const QString &
charSetName ) [static]
Returns some sample characters which are in the charset
charSetName.
QStringList QFontDatabase::charSets ( const QString & family,
bool onlyForLocale = TRUE ) const
Returns a list of all char sets in which the font family
is available in the current locale if onlyForLocale is
TRUE, otherwise all charsets of family independent of the
locale are returned.
QStringList QFontDatabase::families ( bool onlyForLocale = TRUE )
const
Returns a list of names of all available font families in
the current locale if onlyForLocale is TRUE, otherwise
really all available font families independent of the
current locale are returned.
If a family exists in several foundries, the returned name
will be "foundry-family".
QFont QFontDatabase::font ( const QString family, const QString &
style, int pointSize, const QString charSet =
QString::null )
Returns a QFont object which matches the settings of
family, style, pointsize and charSet. If no matching font
could be created an empty QFont object is returned.
bool QFontDatabase::isBitmapScalable ( const QString & family,
const QString & style = QString::null, const QString &
charSet = QString::null ) const
Returns whether the font which matches family, style and
charSet is a scaleable bitmap font. Scaling a bitmap font
produces a bad, often hardly readable result, as the
pixels of the font are scaled. It's better to scale such a
font only to the available fixed sizes (which you can get
with smoothSizes()).
See also isScalable() and isSmoothlyScalable().
Trolltech AS 13 June 2001 2
QFontDatabase(3qt)QFontDatabase(3qt)bool QFontDatabase::isFixedPitch ( const QString & family, const
QString & style = QString::null, const QString & charSet =
QString::null ) const
Returns whether the font which matches family, style and
charSet is fixed pitch.
bool QFontDatabase::isScalable ( const QString & family, const
QString & style = QString::null, const QString & charSet =
QString::null ) const
Returns TRUE if the font which matches the settings
family, style and charSet is scaleable.
See also isBitmapScalable() and isSmoothlyScalable().
bool QFontDatabase::isSmoothlyScalable ( const QString & family,
const QString & style = QString::null, const QString &
charSet = QString::null ) const
Returns whether the font which matches family, style and
charSet is a smoothly scaleable. If this function returns
TRUE, it's save to scale this font to every size as the
result will always look good.
See also isScalable() and isBitmapScalable().
bool QFontDatabase::italic ( const QString & family, const
QString & style, const QString & charSet = QString::null )
const
Returns if the font which matches the settings family,
style and charSet is italic or not.
See also weight() and bold().
QValueList<;int> QFontDatabase::pointSizes ( const QString &
family, const QString & style = QString::null, const
QString & charSet = QString::null )
Returns a list of all available sizes of the font family
in the style style and the char set charSet.
See also smoothSizes() and standardSizes().
QValueList<;int> QFontDatabase::smoothSizes ( const QString &
family, const QString & style, const QString & charSet =
QString::null )
Returns the point sizes of a font which matches family,
style and charSet, that is guaranteed to look good. For
non-scalable fonts and smoothly scalable fonts this
function is equivalent to pointSizes().
See also pointSizes() and standardSizes().
QValueList<;int> QFontDatabase::standardSizes () [static]
Returns a list of standard fontsizes.
See also smoothSizes() and pointSizes().
Trolltech AS 13 June 2001 3
QFontDatabase(3qt)QFontDatabase(3qt)QString QFontDatabase::styleString ( const QFont & f )
Returns a string with describes the style of the font f.
This is Something like" Bold Italic".
QStringList QFontDatabase::styles ( const QString & family, const
QString & charSet = QString::null ) const
Retruns all available styles of the font family in the
char set charSet.
QString QFontDatabase::verboseCharSetName ( const QString &
charSetName ) [static]
Returns a string which gives a quite detailed description
of the charSetName which can be used e.g. for displaying
in a dialog for the user.
int QFontDatabase::weight ( const QString & family, const QString
& style, const QString & charSet = QString::null ) const
Returns the weight of the font which matches the settings
family, style and charSet.
See also italic() and bold().
SEE ALSO
http://doc.trolltech.com/qfontdatabase.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
(qfontdatabase.3qt) and the Qt version (2.3.1).
Trolltech AS 13 June 2001 4
