<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > TQFontDatabase Class< / title >
< style type = "text/css" > < ! - -
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
-->< / style >
< / head >
< body >
< table border = "0" cellpadding = "0" cellspacing = "0" width = "100%" >
< tr bgcolor = "#E5E5E5" >
< td valign = center >
< a href = "index.html" >
< font color = "#004faf" > Home< / font > < / a >
| < a href = "classes.html" >
< font color = "#004faf" > All Classes< / font > < / a >
| < a href = "mainclasses.html" >
< font color = "#004faf" > Main Classes< / font > < / a >
| < a href = "annotated.html" >
< font color = "#004faf" > Annotated< / font > < / a >
| < a href = "groups.html" >
< font color = "#004faf" > Grouped Classes< / font > < / a >
| < a href = "functions.html" >
< font color = "#004faf" > Functions< / font > < / a >
< / td >
< td align = "right" valign = "center" > < img src = "logo32.png" align = "right" width = "64" height = "32" border = "0" > < / td > < / tr > < / table > < h1 align = center > TQFontDatabase Class Reference< / h1 >
< p > The TQFontDatabase class provides information about the fonts available in the underlying window system.
< a href = "#details" > More...< / a >
< p > < tt > #include < < a href = "tqfontdatabase-h.html" > tqfontdatabase.h< / a > > < / tt >
< p > < a href = "tqfontdatabase-members.html" > List of all member functions.< / a >
< h2 > Public Members< / h2 >
< ul >
< li class = fn > < a href = "#TQFontDatabase" > < b > TQFontDatabase< / b > < / a > ()< / li >
< li class = fn > TQStringList < a href = "#families" > < b > families< / b > < / a > () const< / li >
< li class = fn > TQStringList < a href = "#families-2" > < b > families< / b > < / a > ( TQFont::Script script ) const< / li >
< li class = fn > TQStringList < a href = "#styles" > < b > styles< / b > < / a > ( const TQString & family ) const< / li >
< li class = fn > TQValueList< int> < a href = "#pointSizes" > < b > pointSizes< / b > < / a > ( const TQString & family, const TQString & style = TQString::null )< / li >
< li class = fn > TQValueList< int> < a href = "#smoothSizes" > < b > smoothSizes< / b > < / a > ( const TQString & family, const TQString & style )< / li >
< li class = fn > TQString < a href = "#styleString" > < b > styleString< / b > < / a > ( const TQFont & f )< / li >
< li class = fn > TQFont < a href = "#font" > < b > font< / b > < / a > ( const TQString & family, const TQString & style, int pointSize )< / li >
< li class = fn > bool < a href = "#isBitmapScalable" > < b > isBitmapScalable< / b > < / a > ( const TQString & family, const TQString & style = TQString::null ) const< / li >
< li class = fn > bool < a href = "#isSmoothlyScalable" > < b > isSmoothlyScalable< / b > < / a > ( const TQString & family, const TQString & style = TQString::null ) const< / li >
< li class = fn > bool < a href = "#isScalable" > < b > isScalable< / b > < / a > ( const TQString & family, const TQString & style = TQString::null ) const< / li >
< li class = fn > bool < a href = "#isFixedPitch" > < b > isFixedPitch< / b > < / a > ( const TQString & family, const TQString & style = TQString::null ) const< / li >
< li class = fn > bool < a href = "#italic" > < b > italic< / b > < / a > ( const TQString & family, const TQString & style ) const< / li >
< li class = fn > bool < a href = "#bold" > < b > bold< / b > < / a > ( const TQString & family, const TQString & style ) const< / li >
< li class = fn > int < a href = "#weight" > < b > weight< / b > < / a > ( const TQString & family, const TQString & style ) const< / li >
< li class = fn > TQStringList families ( bool ) const < em > (obsolete)< / em > < / li >
< li class = fn > TQStringList styles ( const TQString & family, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > TQValueList< int> pointSizes ( const TQString & family, const TQString & style, const TQString & ) < em > (obsolete)< / em > < / li >
< li class = fn > TQValueList< int> smoothSizes ( const TQString & family, const TQString & style, const TQString & ) < em > (obsolete)< / em > < / li >
< li class = fn > TQFont font ( const TQString & familyName, const TQString & style, int pointSize, const TQString & ) < em > (obsolete)< / em > < / li >
< li class = fn > bool isBitmapScalable ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > bool isSmoothlyScalable ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > bool isScalable ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > bool isFixedPitch ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > bool italic ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > bool bold ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< li class = fn > int weight ( const TQString & family, const TQString & style, const TQString & ) const < em > (obsolete)< / em > < / li >
< / ul >
< h2 > Static Public Members< / h2 >
< ul >
< li class = fn > TQValueList< int> < a href = "#standardSizes" > < b > standardSizes< / b > < / a > ()< / li >
< li class = fn > TQString < a href = "#scriptName" > < b > scriptName< / b > < / a > ( TQFont::Script script )< / li >
< li class = fn > TQString < a href = "#scriptSample" > < b > scriptSample< / b > < / a > ( TQFont::Script script )< / li >
< / ul >
< hr > < a name = "details" > < / a > < h2 > Detailed Description< / h2 >
The TQFontDatabase class provides information about the fonts available in the underlying window system.
< p >
< p > The most common uses of this class are to query the database for
the list of font < a href = "#families" > families< / a > () and for the < a href = "#pointSizes" > pointSizes< / a > () and < a href = "#styles" > styles< / a > ()
that are available for each family. An alternative to pointSizes()
is < a href = "#smoothSizes" > smoothSizes< / a > () which returns the sizes at which a given family
and style will look attractive.
< p > 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 TQt 2.x "foundry-family" format,
e.g. "Cronyx-Helvetica", or the new bracketed TQt 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.
< p > The < a href = "#font" > font< / a > () function returns a < a href = "tqfont.html" > TQFont< / a > given a family, style and
point size.
< p > A family and style combination can be checked to see if it is
< a href = "#italic" > italic< / a > () or < a href = "#bold" > bold< / a > (), and to retrieve its < a href = "#weight" > weight< / a > (). Similarly we can
call < a href = "#isBitmapScalable" > isBitmapScalable< / a > (), < a href = "#isSmoothlyScalable" > isSmoothlyScalable< / a > (), < a href = "#isScalable" > isScalable< / a > () and
< a href = "#isFixedPitch" > isFixedPitch< / a > ().
< p > A text version of a style is given by < a href = "#styleString" > styleString< / a > ().
< p > The TQFontDatabase class also supports some static functions, for
example, < a href = "#standardSizes" > standardSizes< / a > (). You can retrieve the Unicode 3.0
description of a < a href = "tqfont.html#Script-enum" > script< / a > using
< a href = "#scriptName" > scriptName< / a > (), and a sample of characters in a script with
< a href = "#scriptSample" > scriptSample< / a > ().
< p > Example:
< pre >
#include < < a href = "tqapplication-h.html" > tqapplication.h< / a > >
#include < < a href = "tqfontdatabase-h.html" > tqfontdatabase.h< / a > >
#include < else.h>
int main( int argc, char **argv )
{
< a href = "tqapplication.html" > TQApplication< / a > app( argc, argv );
TQFontDatabase fdb;
< a href = "tqstringlist.html" > TQStringList< / a > families = fdb.< a href = "#families" > families< / a > ();
for ( TQStringList::Iterator f = families.< a href = "tqvaluelist.html#begin" > begin< / a > (); f != families.< a href = "tqvaluelist.html#end" > end< / a > (); ++f ) {
< a href = "tqstring.html" > TQString< / a > family = *f;
< a href = "tqapplication.html#qDebug" > tqDebug< / a > ( family );
< a href = "tqstringlist.html" > TQStringList< / a > styles = fdb.< a href = "#styles" > styles< / a > ( family );
for ( TQStringList::Iterator s = styles.< a href = "tqvaluelist.html#begin" > begin< / a > (); s != styles.< a href = "tqvaluelist.html#end" > end< / a > (); ++s ) {
< a href = "tqstring.html" > TQString< / a > style = *s;
< a href = "tqstring.html" > TQString< / a > dstyle = "\t" + style + " (";
< a href = "tqvaluelist.html" > TQValueList< / a > < int> smoothies = fdb.< a href = "#smoothSizes" > smoothSizes< / a > ( family, style );
for ( TQValueList< int> ::Iterator points = smoothies.< a href = "tqvaluelist.html#begin" > begin< / a > ();
points != smoothies.< a href = "tqvaluelist.html#end" > end< / a > (); ++points ) {
dstyle += TQString::< a href = "tqstring.html#number" > number< / a > ( *points ) + " ";
}
dstyle = dstyle.< a href = "tqstring.html#left" > left< / a > ( dstyle.< a href = "tqstring.html#length" > length< / a > () - 1 ) + ")";
< a href = "tqapplication.html#qDebug" > tqDebug< / a > ( dstyle );
}
}
return 0;
}
< / pre >
This example gets the list of font families, then the list of
styles for each family and the point sizes that are available for
each family/style combination.
< p > See also < a href = "environment.html" > Environment Classes< / a > and < a href = "graphics.html" > Graphics Classes< / a > .
< hr > < h2 > Member Function Documentation< / h2 >
< h3 class = fn > < a name = "TQFontDatabase" > < / a > TQFontDatabase::TQFontDatabase ()
< / h3 >
Creates a font database object.
< h3 class = fn > bool < a name = "bold" > < / a > TQFontDatabase::bold ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is bold; otherwise returns FALSE.
< p > < p > See also < a href = "#italic" > italic< / a > () and < a href = "#weight" > weight< / a > ().
< h3 class = fn > bool < a name = "bold-2" > < / a > TQFontDatabase::bold ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > < a href = "tqstringlist.html" > TQStringList< / a > < a name = "families" > < / a > TQFontDatabase::families () const
< / h3 > Returns a sorted list of the names of the available font families.
< p > If a family exists in several foundries, the returned name for
that font is in the form "family [foundry]". Examples: "Times
[Adobe]", "Times [Cronyx]", "Palatino".
< h3 class = fn > < a href = "tqstringlist.html" > TQStringList< / a > < a name = "families-2" > < / a > TQFontDatabase::families ( < a href = "tqfont.html#Script-enum" > TQFont::Script< / a > script ) const
< / h3 >
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
< p > Returns a sorted list of the available font families which support
the Unicode script < em > script< / em > .
< p > If a family exists in several foundries, the returned name for
that font is in the form "family [foundry]". Examples: "Times
[Adobe]", "Times [Cronyx]", "Palatino".
< h3 class = fn > < a href = "tqstringlist.html" > TQStringList< / a > < a name = "families-3" > < / a > TQFontDatabase::families ( bool ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > < a href = "tqfont.html" > TQFont< / a > < a name = "font" > < / a > TQFontDatabase::font ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, int pointSize )
< / h3 >
Returns a < a href = "tqfont.html" > TQFont< / a > object that has family < em > family< / em > , style < em > style< / em >
and point size < em > pointSize< / em > . If no matching font could be created,
a TQFont object that uses the application's default font is
returned.
< h3 class = fn > < a href = "tqfont.html" > TQFont< / a > < a name = "font-2" > < / a > TQFontDatabase::font ( const < a href = "tqstring.html" > TQString< / a > & familyName, const < a href = "tqstring.html" > TQString< / a > & style, int pointSize, const < a href = "tqstring.html" > TQString< / a > & )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > bool < a name = "isBitmapScalable" > < / a > TQFontDatabase::isBitmapScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style = TQString::null ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is a scalable bitmap font; otherwise returns FALSE. Scaling
a bitmap font usually produces an unattractive hardly readable
result, because the pixels of the font are scaled. If you need to
scale a bitmap font it is better to scale it to one of the fixed
sizes returned by < a href = "#smoothSizes" > smoothSizes< / a > ().
< p > < p > See also < a href = "#isScalable" > isScalable< / a > () and < a href = "#isSmoothlyScalable" > isSmoothlyScalable< / a > ().
< h3 class = fn > bool < a name = "isBitmapScalable-2" > < / a > TQFontDatabase::isBitmapScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > bool < a name = "isFixedPitch" > < / a > TQFontDatabase::isFixedPitch ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style = TQString::null ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is fixed pitch; otherwise returns FALSE.
< h3 class = fn > bool < a name = "isFixedPitch-2" > < / a > TQFontDatabase::isFixedPitch ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > bool < a name = "isScalable" > < / a > TQFontDatabase::isScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style = TQString::null ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is scalable; otherwise returns FALSE.
< p > < p > See also < a href = "#isBitmapScalable" > isBitmapScalable< / a > () and < a href = "#isSmoothlyScalable" > isSmoothlyScalable< / a > ().
< h3 class = fn > bool < a name = "isScalable-2" > < / a > TQFontDatabase::isScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > bool < a name = "isSmoothlyScalable" > < / a > TQFontDatabase::isSmoothlyScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style = TQString::null ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is smoothly scalable; otherwise returns FALSE. If this
function returns TRUE, it's safe to scale this font to any size,
and the result will always look attractive.
< p > < p > See also < a href = "#isScalable" > isScalable< / a > () and < a href = "#isBitmapScalable" > isBitmapScalable< / a > ().
< h3 class = fn > bool < a name = "isSmoothlyScalable-2" > < / a > TQFontDatabase::isSmoothlyScalable ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > bool < a name = "italic" > < / a > TQFontDatabase::italic ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style ) const
< / h3 >
Returns TRUE if the font that has family < em > family< / em > and style < em > style< / em > is italic; otherwise returns FALSE.
< p > < p > See also < a href = "#weight" > weight< / a > () and < a href = "#bold" > bold< / a > ().
< h3 class = fn > bool < a name = "italic-2" > < / a > TQFontDatabase::italic ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > < a href = "tqvaluelist.html" > TQValueList< / a > < int> < a name = "pointSizes" > < / a > TQFontDatabase::pointSizes ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style = TQString::null )
< / h3 >
Returns a list of the point sizes available for the font that has
family < em > family< / em > and style < em > style< / em > . The list may be empty.
< p > < p > See also < a href = "#smoothSizes" > smoothSizes< / a > () and < a href = "#standardSizes" > standardSizes< / a > ().
< h3 class = fn > < a href = "tqvaluelist.html" > TQValueList< / a > < int> < a name = "pointSizes-2" > < / a > TQFontDatabase::pointSizes ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > < a href = "tqstring.html" > TQString< / a > < a name = "scriptName" > < / a > TQFontDatabase::scriptName ( < a href = "tqfont.html#Script-enum" > TQFont::Script< / a > script )< tt > [static]< / tt >
< / h3 >
Returns a string that gives a default description of the < em > script< / em >
(e.g. for displaying to the user in a dialog). The name matches
the name of the script as defined by the Unicode 3.0 standard.
< p > < p > See also < a href = "tqfont.html#Script-enum" > TQFont::Script< / a > .
< h3 class = fn > < a href = "tqstring.html" > TQString< / a > < a name = "scriptSample" > < / a > TQFontDatabase::scriptSample ( < a href = "tqfont.html#Script-enum" > TQFont::Script< / a > script )< tt > [static]< / tt >
< / h3 >
Returns a string with sample characters from < em > script< / em > .
< p > < p > See also < a href = "tqfont.html#Script-enum" > TQFont::Script< / a > .
< h3 class = fn > < a href = "tqvaluelist.html" > TQValueList< / a > < int> < a name = "smoothSizes" > < / a > TQFontDatabase::smoothSizes ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style )
< / h3 >
Returns the point sizes of a font that has family < em > family< / em > and
style < em > style< / em > that will look attractive. The list may be empty.
For non-scalable fonts and bitmap scalable fonts, this function
is equivalent to < a href = "#pointSizes" > pointSizes< / a > ().
< p > < p > See also < a href = "#pointSizes" > pointSizes< / a > () and < a href = "#standardSizes" > standardSizes< / a > ().
< h3 class = fn > < a href = "tqvaluelist.html" > TQValueList< / a > < int> < a name = "smoothSizes-2" > < / a > TQFontDatabase::smoothSizes ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & )
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > < a href = "tqvaluelist.html" > TQValueList< / a > < int> < a name = "standardSizes" > < / a > TQFontDatabase::standardSizes ()< tt > [static]< / tt >
< / h3 >
Returns a list of standard font sizes.
< p > < p > See also < a href = "#smoothSizes" > smoothSizes< / a > () and < a href = "#pointSizes" > pointSizes< / a > ().
< h3 class = fn > < a href = "tqstring.html" > TQString< / a > < a name = "styleString" > < / a > TQFontDatabase::styleString ( const < a href = "tqfont.html" > TQFont< / a > & f )
< / h3 >
Returns a string that describes the style of the font < em > f< / em > . For
example, "Bold Italic", "Bold", "Italic" or "Normal". An empty
string may be returned.
< h3 class = fn > < a href = "tqstringlist.html" > TQStringList< / a > < a name = "styles" > < / a > TQFontDatabase::styles ( const < a href = "tqstring.html" > TQString< / a > & family ) const
< / h3 >
Returns a list of the styles available for the font family < em > family< / em > . Some example styles: "Light", "Light Italic", "Bold",
"Oblique", "Demi". The list may be empty.
< h3 class = fn > < a href = "tqstringlist.html" > TQStringList< / a > < a name = "styles-2" > < / a > TQFontDatabase::styles ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
< h3 class = fn > int < a name = "weight" > < / a > TQFontDatabase::weight ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style ) const
< / h3 >
Returns the weight of the font that has family < em > family< / em > and style
< em > style< / em > . If there is no such family and style combination,
returns -1.
< p > < p > See also < a href = "#italic" > italic< / a > () and < a href = "#bold" > bold< / a > ().
< h3 class = fn > int < a name = "weight-2" > < / a > TQFontDatabase::weight ( const < a href = "tqstring.html" > TQString< / a > & family, const < a href = "tqstring.html" > TQString< / a > & style, const < a href = "tqstring.html" > TQString< / a > & ) const
< / h3 >
< b > This function is obsolete.< / b > It is provided to keep old source working. We strongly advise against using it in new code.
< p >
<!-- eof -->
< hr > < p >
This file is part of the < a href = "index.html" > TQt toolkit< / a > .
Copyright © 1995-2007
< a href = "http://www.trolltech.com/" > Trolltech< / a > . All Rights Reserved.< p > < address > < hr > < div align = center >
< table width = 100% cellspacing = 0 border = 0 > < tr >
< td > Copyright © 2007
< a href = "troll.html" > Trolltech< / a > < td align = center > < a href = "trademarks.html" > Trademarks< / a >
< td align = right > < div align = right > TQt 3.3.8< / div >
< / table > < / div > < / address > < / body >
< / html >
