<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qfontdatabase.cpp:1286 -->
<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="qfontdatabase-h.html">ntqfontdatabase.h</a>></tt>
<p><a href="qfontdatabase-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="ntqfont.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="ntqfont.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="qapplication-h.html">ntqapplication.h</a>>
#include <<a href="qfontdatabase-h.html">ntqfontdatabase.h</a>>
#include <else.h>
int main( int argc, char **argv )
{
<a href="ntqapplication.html">TQApplication</a> app( argc, argv );
TQFontDatabase fdb;
<a href="ntqstringlist.html">TQStringList</a> families = fdb.<a href="#families">families</a>();
for ( TQStringList::Iterator f = families.<a href="ntqvaluelist.html#begin">begin</a>(); f != families.<a href="ntqvaluelist.html#end">end</a>(); ++f ) {
<a href="ntqstring.html">TQString</a> family = *f;
<a href="ntqapplication.html#qDebug">tqDebug</a>( family );
<a href="ntqstringlist.html">TQStringList</a> styles = fdb.<a href="#styles">styles</a>( family );
for ( TQStringList::Iterator s = styles.<a href="ntqvaluelist.html#begin">begin</a>(); s != styles.<a href="ntqvaluelist.html#end">end</a>(); ++s ) {
<a href="ntqstring.html">TQString</a> style = *s;
<a href="ntqstring.html">TQString</a> dstyle = "\t" + style + " (";
<a href="ntqvaluelist.html">TQValueList</a><int> smoothies = fdb.<a href="#smoothSizes">smoothSizes</a>( family, style );
for ( TQValueList<int>::Iterator points = smoothies.<a href="ntqvaluelist.html#begin">begin</a>();
points != smoothies.<a href="ntqvaluelist.html#end">end</a>(); ++points ) {
dstyle += TQString::<a href="ntqstring.html#number">number</a>( *points ) + " ";
}
dstyle = dstyle.<a href="ntqstring.html#left">left</a>( dstyle.<a href="ntqstring.html#length">length</a>() - 1 ) + ")";
<a href="ntqapplication.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstringlist.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="ntqstringlist.html">TQStringList</a> <a name="families-2"></a>TQFontDatabase::families ( <a href="ntqfont.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="ntqstringlist.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="ntqfont.html">TQFont</a> <a name="font"></a>TQFontDatabase::font ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, int pointSize )
</h3>
Returns a <a href="ntqfont.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="ntqfont.html">TQFont</a> <a name="font-2"></a>TQFontDatabase::font ( const <a href="ntqstring.html">TQString</a> & familyName, const <a href="ntqstring.html">TQString</a> & style, int pointSize, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqvaluelist.html">TQValueList</a><int> <a name="pointSizes"></a>TQFontDatabase::pointSizes ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqvaluelist.html">TQValueList</a><int> <a name="pointSizes-2"></a>TQFontDatabase::pointSizes ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqstring.html">TQString</a> <a name="scriptName"></a>TQFontDatabase::scriptName ( <a href="ntqfont.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="ntqfont.html#Script-enum">TQFont::Script</a>.
<h3 class=fn><a href="ntqstring.html">TQString</a> <a name="scriptSample"></a>TQFontDatabase::scriptSample ( <a href="ntqfont.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="ntqfont.html#Script-enum">TQFont::Script</a>.
<h3 class=fn><a href="ntqvaluelist.html">TQValueList</a><int> <a name="smoothSizes"></a>TQFontDatabase::smoothSizes ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqvaluelist.html">TQValueList</a><int> <a name="smoothSizes-2"></a>TQFontDatabase::smoothSizes ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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="ntqvaluelist.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="ntqstring.html">TQString</a> <a name="styleString"></a>TQFontDatabase::styleString ( const <a href="ntqfont.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="ntqstringlist.html">TQStringList</a> <a name="styles"></a>TQFontDatabase::styles ( const <a href="ntqstring.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="ntqstringlist.html">TQStringList</a> <a name="styles-2"></a>TQFontDatabase::styles ( const <a href="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.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="ntqstring.html">TQString</a> & family, const <a href="ntqstring.html">TQString</a> & style, const <a href="ntqstring.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>