diff options
Diffstat (limited to 'doc/html/qfontdatabase.html')
| -rw-r--r-- | doc/html/qfontdatabase.html | 322 |
1 files changed, 0 insertions, 322 deletions
diff --git a/doc/html/qfontdatabase.html b/doc/html/qfontdatabase.html deleted file mode 100644 index 5ef80be18..000000000 --- a/doc/html/qfontdatabase.html +++ /dev/null @@ -1,322 +0,0 @@ -<!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">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="#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="qfont.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="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">TQApplication</a> app( argc, argv ); - TQFontDatabase fdb; - <a href="qstringlist.html">TQStringList</a> families = fdb.<a href="#families">families</a>(); - for ( TQStringList::Iterator f = families.<a href="qvaluelist.html#begin">begin</a>(); f != families.<a href="qvaluelist.html#end">end</a>(); ++f ) { - <a href="qstring.html">TQString</a> family = *f; - <a href="qapplication.html#qDebug">qDebug</a>( family ); - <a href="qstringlist.html">TQStringList</a> styles = fdb.<a href="#styles">styles</a>( family ); - for ( TQStringList::Iterator s = styles.<a href="qvaluelist.html#begin">begin</a>(); s != styles.<a href="qvaluelist.html#end">end</a>(); ++s ) { - <a href="qstring.html">TQString</a> style = *s; - <a href="qstring.html">TQString</a> dstyle = "\t" + style + " ("; - <a href="qvaluelist.html">TQValueList</a><int> smoothies = fdb.<a href="#smoothSizes">smoothSizes</a>( family, style ); - for ( TQValueList<int>::Iterator points = smoothies.<a href="qvaluelist.html#begin">begin</a>(); - points != smoothies.<a href="qvaluelist.html#end">end</a>(); ++points ) { - dstyle += TQString::<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="TQFontDatabase"></a>TQFontDatabase::TQFontDatabase () -</h3> -Creates a font database object. - -<h3 class=fn>bool <a name="bold"></a>TQFontDatabase::bold ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstringlist.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="qstringlist.html">TQStringList</a> <a name="families-2"></a>TQFontDatabase::families ( <a href="qfont.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="qstringlist.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="qfont.html">TQFont</a> <a name="font"></a>TQFontDatabase::font ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, int pointSize ) -</h3> -Returns a <a href="qfont.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="qfont.html">TQFont</a> <a name="font-2"></a>TQFontDatabase::font ( const <a href="qstring.html">TQString</a> & familyName, const <a href="qstring.html">TQString</a> & style, int pointSize, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qvaluelist.html">TQValueList</a><int> <a name="pointSizes"></a>TQFontDatabase::pointSizes ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.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="qvaluelist.html">TQValueList</a><int> <a name="pointSizes-2"></a>TQFontDatabase::pointSizes ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qstring.html">TQString</a> <a name="scriptName"></a>TQFontDatabase::scriptName ( <a href="qfont.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="qfont.html#Script-enum">TQFont::Script</a>. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="scriptSample"></a>TQFontDatabase::scriptSample ( <a href="qfont.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="qfont.html#Script-enum">TQFont::Script</a>. - -<h3 class=fn><a href="qvaluelist.html">TQValueList</a><int> <a name="smoothSizes"></a>TQFontDatabase::smoothSizes ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.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="qvaluelist.html">TQValueList</a><int> <a name="smoothSizes-2"></a>TQFontDatabase::smoothSizes ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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="qvaluelist.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="qstring.html">TQString</a> <a name="styleString"></a>TQFontDatabase::styleString ( const <a href="qfont.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="qstringlist.html">TQStringList</a> <a name="styles"></a>TQFontDatabase::styles ( const <a href="qstring.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="qstringlist.html">TQStringList</a> <a name="styles-2"></a>TQFontDatabase::styles ( const <a href="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.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="qstring.html">TQString</a> & family, const <a href="qstring.html">TQString</a> & style, const <a href="qstring.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> |