QFontDatabase

NAME

SYNOPSIS

Public Members

Static Public Members

DESCRIPTION

The most common uses of this class are to query the database for the list of font families() and for the pointSizes() and styles() that are available for each family. An alternative to pointSizes() is smoothSizes() which returns the sizes at which a given family and style will look attractive.

If the font family is available from two or more foundries the foundry name is included in the family name, e.g. "Helvetica [Adobe]" and "Helvetica [Cronyx]". When you specify a family you can either use the old hyphenated Qt 2.x "foundry-family" format, e.g. "Cronyx-Helvetica", or the new bracketed Qt 3.x "family [foundry]" format e.g. "Helvetica [Cronyx]". If the family has a foundry it is always returned, e.g. by families(), using the bracketed format.

The font() function returns a QFont given a family, style and point size.

A family and style combination can be checked to see if it is italic() or bold(), and to retrieve its weight(). Similarly we can call isBitmapScalable(), isSmoothlyScalable(), isScalable() and isFixedPitch().

A text version of a style is given by styleString().

The QFontDatabase class also supports some static functions, for example, standardSizes(). You can retrieve the Unicode 3.0 description of a script using scriptName(), and a sample of characters in a script with scriptSample().

Example:

#include <qapplication.h>


#include <qfontdatabase.h>


#include <else.h>




int main( int argc, char **argv )


{


    QApplication app( argc, argv );


    QFontDatabase fdb;


    QStringList families = fdb.families();


    for ( QStringList::Iterator f = families.begin(); f != families.end(); ++f ) {


        QString family = *f;


        qDebug( family );


        QStringList styles = fdb.styles( family );


        for ( QStringList::Iterator s = styles.begin(); s != styles.end(); ++s ) {


            QString style = *s;


            QString dstyle = "\t" + style + " (";


            QValueList<int> smoothies = fdb.smoothSizes( family, style );


            for ( QValueList<int>::Iterator points = smoothies.begin();


                  points != smoothies.end(); ++points ) {


                dstyle += QString::number( *points ) + " ";


            }


            dstyle = dstyle.left( dstyle.length() - 1 ) + ")";


            qDebug( dstyle );


        }


    }


    return 0;


}

See also Environment Classes and Graphics Classes.  

MEMBER FUNCTION DOCUMENTATION

QFontDatabase::QFontDatabase ()

bool QFontDatabase::bold ( const QString & family, const QString & style ) const

See also italic() and weight().  

bool QFontDatabase::bold ( const QString & family, const QString & style, const QString & ) const

QStringList QFontDatabase::families () const

If a family exists in several foundries, the returned name for that font is in the form "family [foundry]". Examples: [Adobe]", "Times [Cronyx]", "Palatino".  

QStringList QFontDatabase::families ( QFont::Script script ) const

Returns a sorted list of the available font families which support the Unicode script script.

If a family exists in several foundries, the returned name for that font is in the form "family [foundry]". Examples: [Adobe]", "Times [Cronyx]", "Palatino".  

QStringList QFontDatabase::families ( bool ) const

QFont QFontDatabase::font ( const QString & family, const QString & style, int pointSize )

QFont QFontDatabase::font ( const QString & familyName, const QString & style, int pointSize, const QString & )

bool QFontDatabase::isBitmapScalable ( const QString & family, const QString & style = QString::null ) const

See also isScalable() and isSmoothlyScalable().  

bool QFontDatabase::isBitmapScalable ( const QString & family, const QString & style, const QString & ) const

bool QFontDatabase::isFixedPitch ( const QString & family, const QString & style = QString::null ) const

bool QFontDatabase::isFixedPitch ( const QString & family, const QString & style, const QString & ) const

bool QFontDatabase::isScalable ( const QString & family, const QString & style = QString::null ) const

See also isBitmapScalable() and isSmoothlyScalable().  

bool QFontDatabase::isScalable ( const QString & family, const QString & style, const QString & ) const

bool QFontDatabase::isSmoothlyScalable ( const QString & family, const QString & style = QString::null ) const

See also isScalable() and isBitmapScalable().  

bool QFontDatabase::isSmoothlyScalable ( const QString & family, const QString & style, const QString & ) const

bool QFontDatabase::italic ( const QString & family, const QString & style ) const

See also weight() and bold().  

bool QFontDatabase::italic ( const QString & family, const QString & style, const QString & ) const

QValueList<int> QFontDatabase::pointSizes ( const QString & family, const QString & style = QString::null )

See also smoothSizes() and standardSizes().  

QValueList<int> QFontDatabase::pointSizes ( const QString & family, const QString & style, const QString & )

QString QFontDatabase::scriptName ( QFont::Script script ) [static]

See also QFont::Script.  

QString QFontDatabase::scriptSample ( QFont::Script script ) [static]

See also QFont::Script.  

QValueList<int> QFontDatabase::smoothSizes ( const QString & family, const QString & style )

See also pointSizes() and standardSizes().  

QValueList<int> QFontDatabase::smoothSizes ( const QString & family, const QString & style, const QString & )

QValueList<int> QFontDatabase::standardSizes () [static]

See also smoothSizes() and pointSizes().  

QString QFontDatabase::styleString ( const QFont & f )

QStringList QFontDatabase::styles ( const QString & family ) const

QStringList QFontDatabase::styles ( const QString & family, const QString & ) const

int QFontDatabase::weight ( const QString & family, const QString & style ) const

See also italic() and bold().  

int QFontDatabase::weight ( const QString & family, const QString & style, const QString & ) const

SEE ALSO

COPYRIGHT

AUTHOR

BUGS