qfont.3qt

Linux下的基于X11的图形开发环境。

.)l chart/optionsform.cpp and fonts/simple-qfont-demo/viewer.cpp.
.SH "bool QFont::fixedPitch () const"
Returns TRUE if fixed pitch has been set; otherwise returns FALSE.
.PP
See also setFixedPitch() and QFontInfo::fixedPitch().
.SH "bool QFont::fromString ( const QString & descrip )"
Sets this font to match the description \fIdescrip\fR. The description is a comma-separated list of the font attributes, as returned by toString().
.PP
See also toString() and operator>>().
.SH "HFONT QFont::handle () const"
Returns the window system handle to the font, for low-level access. Using this function is \fInot\fR portable.
.SH "void QFont::insertSubstitution ( const QString & familyName, const QString & substituteName )\fC [static]\fR"
Inserts the family name \fIsubstituteName\fR into the substitution table for \fIfamilyName\fR.
.PP
See also insertSubstitutions(), removeSubstitution(), substitutions(), substitute(), and substitutes().
.PP
Example: fonts/simple-qfont-demo/viewer.cpp.
.SH "void QFont::insertSubstitutions ( const QString & familyName, const QStringList & substituteNames )\fC [static]\fR"
Inserts the list of families \fIsubstituteNames\fR into the substitution list for \fIfamilyName\fR.
.PP
See also insertSubstitution(), removeSubstitution(), substitutions(), and substitute().
.PP
Example: fonts/simple-qfont-demo/viewer.cpp.
.SH "bool QFont::isCopyOf ( const QFont & f ) const"
Returns TRUE if this font and \fIf\fR are copies of each other, i.e. one of them was created as a copy of the other and neither has been modified since. This is much stricter than equality.
.PP
See also operator=() and operator==().
.SH "bool QFont::italic () const"
Returns TRUE if italic has been set; otherwise returns FALSE.
.PP
See also setItalic().
.PP
Example: chart/optionsform.cpp.
.SH "QString QFont::key () const"
Returns the font's key, a textual representation of a font. It is typically used as the key for a cache or dictionary of fonts.
.PP
See also QMap.
.SH "QString QFont::lastResortFamily () const"
Returns the "last resort" font family name.
.PP
The current implementation tries a wide variety of common fonts, returning the first one it finds. Is is possible that no family is found in which case a null string is returned.
.PP
See also lastResortFont().
.SH "QString QFont::lastResortFont () const"
Returns a "last resort" font name for the font matching algorithm. This is used if the last resort family is not available. It will always return a name, if necessary returning something like" fixed" or "system".
.PP
The current implementation tries a wide variety of common fonts, returning the first one it finds. The implementation may change at any time, but this function will always return a string containing something.
.PP
It is theoretically possible that there really isn't a lastResortFont() in which case Qt will abort with an error message. We have not been able to identify a case where this happens. Please report it as a bug if it does, preferably with a list of the fonts you have installed.
.PP
See also lastResortFamily() and rawName().
.SH "bool QFont::operator!= ( const QFont & f ) const"
Returns TRUE if this font is different from \fIf\fR; otherwise returns FALSE.
.PP
Two QFonts are considered to be different if their font attributes are different. If rawMode() is enabled for both fonts, only the family fields are compared.
.PP
See also operator==().
.SH "QFont & QFont::operator= ( const QFont & font )"
Assigns \fIfont\fR to this font and returns a reference to it.
.SH "bool QFont::operator== ( const QFont & f ) const"
Returns TRUE if this font is equal to \fIf\fR; otherwise returns FALSE.
.PP
Two QFonts are considered equal if their font attributes are equal. If rawMode() is enabled for both fonts, only the family fields are compared.
.PP
See also operator!=() and isCopyOf().
.SH "int QFont::pixelSize () const"
Returns the pixel size of the font if it was set with setPixelSize(). Returns -1 if the size was set with setPointSize() or setPointSizeFloat().
.PP
See also setPixelSize(), pointSize(), QFontInfo::pointSize(), and QFontInfo::pixelSize().
.SH "int QFont::pointSize () const"
Returns the point size of the font. Returns -1 if the font size was specified in pixels.
.PP
See also setPointSize(), deciPointSize(), and pointSizeFloat().
.PP
Examples:
.)l chart/optionsform.cpp and fonts/simple-qfont-demo/viewer.cpp.
.SH "float QFont::pointSizeFloat () const"
Returns the point size of the font. Returns -1 if the font size was specified in pixels.
.PP
See also pointSize(), setPointSizeFloat(), pixelSize(), QFontInfo::pointSize(), and QFontInfo::pixelSize().
.SH "void QFont::qwsRenderToDisk ( bool all = TRUE )"
Saves the glyphs in the font that have previously been accessed as a QPF file. If \fIall\fR is TRUE (the default), then before saving, all glyphs are marked as used.
.PP
If the font is large and you are sure that only a subset of characters will ever be required on the target device, passing FALSE for the \fIall\fR parameter can save a significant amount of disk space.
.PP
Note that this function is only applicable on Qt/Embedded.
.SH "bool QFont::rawMode () const"
Returns TRUE if raw mode is used for font name matching; otherwise returns FALSE.
.PP
See also setRawMode() and rawName().
.SH "QString QFont::rawName () const"
Returns the name of the font within the underlying window system. On Windows, this is usually just the family name of a TrueType font. Under X, it is an XLFD (X Logical Font Description). Using the return value of this function is usually \fInot\fR \fIportable\fR.
.PP
See also setRawName().
.SH "void QFont::removeSubstitution ( const QString & familyName )\fC [static]\fR"
Removes all the substitutions for \fIfamilyName\fR.
.PP
See also insertSubstitutions(), insertSubstitution(), substitutions(), and substitute().
.SH "void QFont::setBold ( bool enable )"
If \fIenable\fR is true sets the font's weight to QFont::Bold; otherwise sets the weight to QFont::Normal.
.PP
For finer boldness control use setWeight().
.PP
See also bold() and setWeight().
.PP
Examples:
.)l menu/menu.cpp and themes/metal.cpp.
.SH "void QFont::setDefaultFont ( const QFont & f )\fC [static]\fR"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.PP
Please use QApplication::setFont() instead.
.SH "void QFont::setFamily ( const QString & family )"
Sets the family name of the font. The name is case insensitive and may include a foundry name.
.PP
The \fIfamily\fR name may optionally also include a foundry name, e.g. "Helvetica [Cronyx]". (The Qt 2.x syntax, i.e." Cronyx-Helvetica", is also supported.) If the \fIfamily\fR is available from more than one foundry and the foundry isn't specified, an arbitrary foundry is chosen. If the family isn't available a family will be set using the font matching algorithm.
.PP
See also family(), setStyleHint(), and QFontInfo.
.SH "void QFont::setFixedPitch ( bool enable )"
If \fIenable\fR is TRUE, sets fixed pitch on; otherwise sets fixed pitch off.
.PP
See also fixedPitch() and QFontInfo.
.SH "void QFont::setItalic ( bool enable )"
If \fIenable\fR is TRUE, italic is set on; otherwise italic is set off.
.PP
See also italic() and QFontInfo.
.PP
Examples:
.)l fileiconview/qfileiconview.cpp, fonts/simple-qfont-demo/viewer.cpp, and themes/metal.cpp.
.SH "void QFont::setPixelSize ( int pixelSize )"
Sets the font size to \fIpixelSize\fR pixels.
.PP
Using this function makes the font device dependent. Use setPointSize() or setPointSizeFloat() to set the size of the font in a device independent manner.
.PP
See also pixelSize().
.PP
Example: qwerty/qwerty.cpp.
.SH "void QFont::setPixelSizeFloat ( float pixelSize )"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.PP
Sets the logical pixel height of font characters when shown on the screen to \fIpixelSize\fR.
.SH "void QFont::setPointSize ( int pointSize )"
Sets the point size to \fIpointSize\fR. The point size must be greater than zero.
.PP
See also pointSize() and setPointSizeFloat().
.PP
Example: fonts/simple-qfont-demo/viewer.cpp.
.SH "void QFont::setPointSizeFloat ( float pointSize )"
Sets the point size to \fIpointSize\fR. The point size must be greater than zero. The requested precision may not be achieved on all platforms.
.PP
See also pointSizeFloat(), setPointSize(), and setPixelSize().
.SH "void QFont::setRawMode ( bool enable )"
If \fIenable\fR is TRUE, turns raw mode on; otherwise turns raw mode off. This function only has an effect under X11.
.PP
If raw mode is enabled, Qt will search for an X font with a complete font name matching the family name, ignoring all other values set for the QFont. If the font name matches several fonts, Qt will use the first font returned by X. QFontInfo \fIcannot\fR be used to fetch information about a QFont using raw mode (it will return the values set in the QFont for all parameters, including the family name).
.PP
\fBWarning:\fR Do not use raw mode unless you really, really need it! In most (if not all) cases, setRawName() is a much better choice.
.PP
See also rawMode() and setRawName().
.SH "void QFont::setRawName ( const QString & name )"
Sets a font by its system specific name. The function is particularly useful under X, where system font settings (for example X resources) are usually available in XLFD (X Logical Font Description) form only. You can pass an XLFD as \fIname\fR to this function.
.PP
In Qt 2.0 and later, a font set with setRawName() is still a full-featured QFont. It can be queried (for example with italic()) or modified (for example with setItalic()) and is therefore also suitable for rendering rich text.
.PP
If Qt's internal font database cannot resolve the raw name, the font becomes a raw font with \fIname\fR as its family.
.PP
Note that the present implementation does not handle wildcards in XLFDs well, and that font aliases (file \fCfonts.alias\fR in the font directory on X11) are not supported.
.PP
See also rawName(), setRawMode(), and setFamily().
.SH "void QFont::setStrikeOut ( bool enable )"
If \fIenable\fR is TRUE, sets strikeout on; otherwise sets strikeout off.
.PP
See also strikeOut() and QFontInfo.
.SH "void QFont::setStyleHint ( StyleHint hint, StyleStrategy strategy = PreferDefault )"
Sets the style hint and strategy to \fIhint\fR and \fIstrategy\fR, respectively.
.PP
If these aren't set explicitly the style hint will default to AnyStyle and the style strategy to PreferDefault.
.PP
See also StyleHint, styleHint(), StyleStrategy, styleStrategy(), and QFontInfo.
.PP
Examples:
.)l desktop/desktop.cpp and fonts/simple-qfont-demo/viewer.cpp.
.SH "void QFont::setStyleStrategy ( StyleStrategy s )"
Sets the style strategy for the font to \fIs\fR.
.PP
See also QFont::StyleStrategy.
.SH "void QFont::setUnderline ( bool enable )"
If \fIenable\fR is TRUE, sets underline on; otherwise sets underline off.
.PP
See also underline() and QFontInfo.
.PP
Examples:
.)l fonts/simple-qfont-demo/viewer.cpp and menu/menu.cpp.
.SH "void QFont::setWeight ( int weight )"
Sets the weight the font to \fIweight\fR, which should be a value from the QFont::Weight enumeration.
.PP
See also weight() and QFontInfo.
.PP
Example: fonts/simple-qfont-demo/viewer.cpp.
.SH "bool QFont::strikeOut () const"
Returns TRUE if strikeout has been set; otherwise returns FALSE.
.PP
See also setStrikeOut().
.SH "StyleHint QFont::styleHint () const"
Returns the StyleHint.
.PP
The style hint affects the font matching algorithm. See QFont::StyleHint for the list of strategies.
.PP
See also setStyleHint(), QFont::StyleStrategy, and QFontInfo::styleHint().
.SH "StyleStrategy QFont::styleStrategy () const"
Returns the StyleStrategy.
.PP
The style strategy affects the font matching algorithm. See QFont::StyleStrategy for the list of strategies.
.PP
See also setStyleHint() and QFont::StyleHint.
.SH "QString QFont::substitute ( const QString & familyName )\fC [static]\fR"
Returns the first family name to be used whenever \fIfamilyName\fR is specified. The lookup is case insensitive.
.PP
If there is no substitution for \fIfamilyName\fR, \fIfamilyName\fR is returned.
.PP
To obtain a list of substitutions use substitutes().
.PP
See also setFamily(), insertSubstitutions(), insertSubstitution(), and removeSubstitution().
.SH "QStringList QFont::substitutes ( const QString & familyName )\fC [static]\fR"
Returns a list of family names to be used whenever \fIfamilyName\fR is specified. The lookup is case insensitive.
.PP
If there is no substitution for \fIfamilyName\fR, an empty list is returned.
.PP
See also substitute(), insertSubstitutions(), insertSubstitution(), and removeSubstitution().
.PP
Example: fonts/simple-qfont-demo/viewer.cpp.
.SH "QStringList QFont::substitutions ()\fC [static]\fR"
Returns a sorted list of substituted family names.
.PP
See also insertSubstitution(), removeSubstitution(), and substitute().
.SH "QString QFont::toString () const"
Returns a description of the font. The description is a comma-separated list of the attributes, perfectly suited for use in QSettings.
.PP
See also fromString() and operator<<().
.SH "bool QFont::underline () const"
Returns TRUE if underline has been set; otherwise returns FALSE.
.PP
See also setUnderline().
.SH "int QFont::weight () const"
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
.PP
See also setWeight(), Weight, and QFontInfo.
.SH RELATED FUNCTION DOCUMENTATION
.SH "QDataStream & operator<< ( QDataStream & s, const QFont & font )"
Writes the font \fIfont\fR to the data stream \fIs\fR. (toString() writes to a text stream.)
.PP
See also Format of the QDataStream operators.
.SH "QDataStream & operator>> ( QDataStream & s, QFont & font )"
Reads the font \fIfont\fR from the data stream \fIs\fR. (fromString() reads from a text stream.)
.PP
See also Format of the QDataStream operators.

.SH "SEE ALSO"
.BR http://doc.trolltech.com/qfont.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com.  See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive Qt documentation is provided in HTML format; it is
located at $QTDIR/doc/html and can be read using Qt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech. 
.P
If you find errors in this manual page, please report them to
.BR [e-mail] .
Please include the name of the manual page (qfont.3qt) and the Qt
version (3.1.1).