<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/src/kernel/qfontdatabase.cpp:718 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QFontDatabase Class</title>
<style type="text/css"><!--
h3.fn,span.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>QFontDatabase Class Reference</h1>
<p>The QFontDatabase 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">qfontdatabase.h</a>></tt>
<p><a href="qfontdatabase-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QFontDatabase"><b>QFontDatabase</b></a> ()</div></li>
<li><div class=fn>QStringList <a href="#families"><b>families</b></a> () const</div></li>
<li><div class=fn>QStringList <a href="#styles"><b>styles</b></a> ( const QString & family ) const</div></li>
<li><div class=fn>QValueList<int> <a href="#pointSizes"><b>pointSizes</b></a> ( const QString & family, const QString & style = QString::null )</div></li>
<li><div class=fn>QValueList<int> <a href="#smoothSizes"><b>smoothSizes</b></a> ( const QString & family, const QString & style )</div></li>
<li><div class=fn>QString <a href="#styleString"><b>styleString</b></a> ( const QFont & f )</div></li>
<li><div class=fn>QFont <a href="#font"><b>font</b></a> ( const QString & family, const QString & style, int pointSize )</div></li>
<li><div class=fn>bool <a href="#isBitmapScalable"><b>isBitmapScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</div></li>
<li><div class=fn>bool <a href="#isSmoothlyScalable"><b>isSmoothlyScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</div></li>
<li><div class=fn>bool <a href="#isScalable"><b>isScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</div></li>
<li><div class=fn>bool <a href="#isFixedPitch"><b>isFixedPitch</b></a> ( const QString & family, const QString & style = QString::null ) const</div></li>
<li><div class=fn>bool <a href="#italic"><b>italic</b></a> ( const QString & family, const QString & style ) const</div></li>
<li><div class=fn>bool <a href="#bold"><b>bold</b></a> ( const QString & family, const QString & style ) const</div></li>
<li><div class=fn>int <a href="#weight"><b>weight</b></a> ( const QString & family, const QString & style ) const</div></li>
<li><div class=fn>QStringList families ( bool ) const <em>(obsolete)</em></div></li>
<li><div class=fn>QStringList styles ( const QString & family, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>QValueList<int> pointSizes ( const QString & family, const QString & style, const QString & ) <em>(obsolete)</em></div></li>
<li><div class=fn>QValueList<int> smoothSizes ( const QString & family, const QString & style, const QString & ) <em>(obsolete)</em></div></li>
<li><div class=fn>QFont font ( const QString & familyName, const QString & style, int pointSize, const QString & ) <em>(obsolete)</em></div></li>
<li><div class=fn>bool isBitmapScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>bool isSmoothlyScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>bool isScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>bool isFixedPitch ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>bool italic ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>bool bold ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
<li><div class=fn>int weight ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></div></li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li><div class=fn>QValueList<int> <a href="#standardSizes"><b>standardSizes</b></a> ()</div></li>
<li><div class=fn>QString <a href="#scriptName"><b>scriptName</b></a> ( QFont::Script script )</div></li>
<li><div class=fn>QString <a href="#scriptSample"><b>scriptSample</b></a> ( QFont::Script script )</div></li>
<li><div class=fn>void <b>qwsAddDiskFont</b> ( QDiskFont * qdf )</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
<p> The QFontDatabase class provides information about the fonts available in the underlying window system.
<p> The most common uses of this class are to query the database for the
list of font <a href="#families">families</a>() and 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 hyphenated "foundry-family" format, e.g.
"Cronyx-Helvetica", or the bracketed 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="qfont.html">QFont</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 QFontDatabase 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="qfont.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">qapplication.h</a>>
#include <<a href="qfontdatabase-h.html">qfontdatabase.h</a>>
int main( int argc, char **argv )
{
<a href="qapplication.html">QApplication</a> app( argc, argv );
QFontDatabase fdb;
<a href="qstringlist.html">QStringList</a> families = fdb.<a href="#families">families</a>();
for ( QStringList::Iterator f = families.<a href="qvaluelist.html#begin">begin</a>(); f != families.<a href="qvaluelist.html#end">end</a>(); ++f ) {
<a href="qstring.html">QString</a> family = *f;
<a href="qapplication.html#qDebug">qDebug</a>( family );
<a href="qstringlist.html">QStringList</a> styles = fdb.<a href="#styles">styles</a>( family );
for ( QStringList::Iterator s = styles.<a href="qvaluelist.html#begin">begin</a>(); s != styles.<a href="qvaluelist.html#end">end</a>(); ++s ) {
<a href="qstring.html">QString</a> style = *s;
<a href="qstring.html">QString</a> dstyle = "\t" + style + " (";
<a href="qvaluelist.html">QValueList</a><int> smoothies = fdb.<a href="#smoothSizes">smoothSizes</a>( family, style );
for ( QValueList<int>::Iterator points = smoothies.<a href="qvaluelist.html#begin">begin</a>(); points != smoothies.<a href="qvaluelist.html#end">end</a>(); ++points ) {
dstyle += QString::<a href="qstring.html#number">number</a>( *points ) + " ";
}
dstyle = dstyle.<a href="qstring.html#left">left</a>( dstyle.<a href="qstring.html#length">length</a>() - 1 ) + ")";
<a href="qapplication.html#qDebug">qDebug</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="QFontDatabase"></a>QFontDatabase::QFontDatabase ()
</h3>
Creates a font database object.
<h3 class=fn>bool <a name="bold"></a>QFontDatabase::bold ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</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>QFontDatabase::bold ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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="qstringlist.html">QStringList</a> <a name="families"></a>QFontDatabase::families () const
</h3>
Returns a 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="qstringlist.html">QStringList</a> <a name="families-2"></a>QFontDatabase::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="qfont.html">QFont</a> <a name="font"></a>QFontDatabase::font ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, int pointSize )
</h3> Returns a <a href="qfont.html">QFont</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
QFont object that uses the application's default font is returned.
<h3 class=fn><a href="qfont.html">QFont</a> <a name="font-2"></a>QFontDatabase::font ( const <a href="qstring.html">QString</a> & familyName, const <a href="qstring.html">QString</a> & style, int pointSize, const <a href="qstring.html">QString</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>QFontDatabase::isBitmapScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style = QString::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>QFontDatabase::isBitmapScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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>QFontDatabase::isFixedPitch ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style = QString::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>QFontDatabase::isFixedPitch ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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>QFontDatabase::isScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style = QString::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>QFontDatabase::isScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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>QFontDatabase::isSmoothlyScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style = QString::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>QFontDatabase::isSmoothlyScalable ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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>QFontDatabase::italic ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</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>QFontDatabase::italic ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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="qvaluelist.html">QValueList</a><int> <a name="pointSizes"></a>QFontDatabase::pointSizes ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style = QString::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="qvaluelist.html">QValueList</a><int> <a name="pointSizes-2"></a>QFontDatabase::pointSizes ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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="qstring.html">QString</a> <a name="scriptName"></a>QFontDatabase::scriptName ( <a href="qfont.html#Script-enum">QFont::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 indicated by the Unicode 3.0 standard.
<p> <p>See also <a href="qfont.html#Script-enum">QFont::Script</a>.
<h3 class=fn><a href="qstring.html">QString</a> <a name="scriptSample"></a>QFontDatabase::scriptSample ( <a href="qfont.html#Script-enum">QFont::Script</a> script )<tt> [static]</tt>
</h3>
Returns a string with sample characters from <em>script</em>.
<p> <p>See also <a href="qfont.html#Script-enum">QFont::Script</a>.
<h3 class=fn><a href="qvaluelist.html">QValueList</a><int> <a name="smoothSizes"></a>QFontDatabase::smoothSizes ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</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 smoothly 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="qvaluelist.html">QValueList</a><int> <a name="smoothSizes-2"></a>QFontDatabase::smoothSizes ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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="qvaluelist.html">QValueList</a><int> <a name="standardSizes"></a>QFontDatabase::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="qstring.html">QString</a> <a name="styleString"></a>QFontDatabase::styleString ( const <a href="qfont.html">QFont</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="qstringlist.html">QStringList</a> <a name="styles"></a>QFontDatabase::styles ( const <a href="qstring.html">QString</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="qstringlist.html">QStringList</a> <a name="styles-2"></a>QFontDatabase::styles ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</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>QFontDatabase::weight ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</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>QFontDatabase::weight ( const <a href="qstring.html">QString</a> & family, const <a href="qstring.html">QString</a> & style, const <a href="qstring.html">QString</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">Qt toolkit</a>.
Copyright © 1995-2001
<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 © 2001
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
1297
