diff options
Diffstat (limited to 'doc/html/qfontdatabase.html')
| -rw-r--r-- | doc/html/qfontdatabase.html | 322 |
1 files changed, 322 insertions, 0 deletions
diff --git a/doc/html/qfontdatabase.html b/doc/html/qfontdatabase.html new file mode 100644 index 0000000..9699c36 --- /dev/null +++ b/doc/html/qfontdatabase.html @@ -0,0 +1,322 @@ +<!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>QFontDatabase 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>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 class=fn><a href="#QFontDatabase"><b>QFontDatabase</b></a> ()</li> +<li class=fn>QStringList <a href="#families"><b>families</b></a> () const</li> +<li class=fn>QStringList <a href="#families-2"><b>families</b></a> ( QFont::Script script ) const</li> +<li class=fn>QStringList <a href="#styles"><b>styles</b></a> ( const QString & family ) const</li> +<li class=fn>QValueList<int> <a href="#pointSizes"><b>pointSizes</b></a> ( const QString & family, const QString & style = QString::null )</li> +<li class=fn>QValueList<int> <a href="#smoothSizes"><b>smoothSizes</b></a> ( const QString & family, const QString & style )</li> +<li class=fn>QString <a href="#styleString"><b>styleString</b></a> ( const QFont & f )</li> +<li class=fn>QFont <a href="#font"><b>font</b></a> ( const QString & family, const QString & style, int pointSize )</li> +<li class=fn>bool <a href="#isBitmapScalable"><b>isBitmapScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</li> +<li class=fn>bool <a href="#isSmoothlyScalable"><b>isSmoothlyScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</li> +<li class=fn>bool <a href="#isScalable"><b>isScalable</b></a> ( const QString & family, const QString & style = QString::null ) const</li> +<li class=fn>bool <a href="#isFixedPitch"><b>isFixedPitch</b></a> ( const QString & family, const QString & style = QString::null ) const</li> +<li class=fn>bool <a href="#italic"><b>italic</b></a> ( const QString & family, const QString & style ) const</li> +<li class=fn>bool <a href="#bold"><b>bold</b></a> ( const QString & family, const QString & style ) const</li> +<li class=fn>int <a href="#weight"><b>weight</b></a> ( const QString & family, const QString & style ) const</li> +<li class=fn>QStringList families ( bool ) const <em>(obsolete)</em></li> +<li class=fn>QStringList styles ( const QString & family, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>QValueList<int> pointSizes ( const QString & family, const QString & style, const QString & ) <em>(obsolete)</em></li> +<li class=fn>QValueList<int> smoothSizes ( const QString & family, const QString & style, const QString & ) <em>(obsolete)</em></li> +<li class=fn>QFont font ( const QString & familyName, const QString & style, int pointSize, const QString & ) <em>(obsolete)</em></li> +<li class=fn>bool isBitmapScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>bool isSmoothlyScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>bool isScalable ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>bool isFixedPitch ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>bool italic ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>bool bold ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +<li class=fn>int weight ( const QString & family, const QString & style, const QString & ) const <em>(obsolete)</em></li> +</ul> +<h2>Static Public Members</h2> +<ul> +<li class=fn>QValueList<int> <a href="#standardSizes"><b>standardSizes</b></a> ()</li> +<li class=fn>QString <a href="#scriptName"><b>scriptName</b></a> ( QFont::Script script )</li> +<li class=fn>QString <a href="#scriptSample"><b>scriptSample</b></a> ( QFont::Script script )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The QFontDatabase 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 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. +<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>> +#include <else.h> + +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 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="qstringlist.html">QStringList</a> <a name="families-2"></a>QFontDatabase::families ( <a href="qfont.html#Script-enum">QFont::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="qstringlist.html">QStringList</a> <a name="families-3"></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 defined 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 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="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-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>Qt 3.3.8</div> +</table></div></address></body> +</html> |