QFontInfo(3qt)

NAME
QFontInfo - General information about fonts

#include <qfontinfo.h>

  Public Members
QFontInfo ( const QFont & )
QFontInfo ( const QFontInfo & )
~QFontInfo ()
QFontInfo& operator= ( const QFontInfo & )
QString family () const
int pointSize () const
bool italic () const
int weight () const
bool bold () const
bool underline () const
bool strikeOut () const
bool fixedPitch () const
QFont::StyleHint styleHint () const
QFont::CharSet charSet () const
bool rawMode () const
bool exactMatch () const

DESCRIPTION
The QFontInfo class provides general information about fonts.

The QFontInfo class mirrors QFont exactly, but where QFont access functions return set values, QFontInfo returns the values that apply to the font in use.

For example, when the program asks for a 25pt Courier font on a machine that has a 24pt Courier font but not a scalable one, QFont will (normally) use the 24pt Courier for rendering. In this case, QFont::pointSize() returns 25 and QFontInfo::pointSize() 24.

The access functions in QFontInfo mirror QFont exactly, except for this difference.

There are three ways to create a QFontInfo object.

The QFontInfo constructor with a QFont creates a font info object for a screen-compatible font, i.e. the font can not be a printer font.

QWidget::fontInfo() returns the font info for a widget's font. This is equivalent to QFontInfo(widget->font()). Setting a new font for the widget later does not affect the font info object.

QPainter::fontInfo() returns the font info for a painter's current font. The font info object is automatically updated if somebody sets a new painter font, unlike the two above cases, which take a" snapshot" of a font.

See also QFont and QFontMetrics.

MEMBER FUNCTION DOCUMENTATION

QFontInfo::QFontInfo ( const QFont & font )
Constructs a font info object for font.

The font must be screen-compatible, i.e. a font you use when drawing text in widgets or pixmaps. If font is a printer font, you'll probably get wrong results.

Use the QPainter::fontInfo() to get the font info when painting. This is a little slower than using this constructor, but it always gives correct results.

QFontInfo::QFontInfo ( const QFontInfo & fi )
Constructs a copy of fi.

QFontInfo::~QFontInfo ()
Destructs the font info object.

bool QFontInfo::bold () const
Returns TRUE if weight() would return a greater than QFont::Normal, and FALSE otherwise.

See also weight() and QFont::bold().

QFont::CharSet QFontInfo::charSet() const
Returns the character set of the matched window system font.

See also QFont::charSet().

bool QFontInfo::exactMatch () const
Returns TRUE if the matched window system font is exactly the one specified by the font.

See also QFont::exactMatch().

QString QFontInfo::family () const
Returns the family name of the matched window system font.

See also QFont::family().

bool QFontInfo::fixedPitch () const
Returns the fixed pitch value of the matched window system font. A fixed pitch font is a font that has constant character pixel width.

See also QFont::fixedPitch().

bool QFontInfo::italic () const
Returns the italic value of the matched window system font.

See also QFont::italic().

QFontInfo & QFontInfo::operator= ( const QFontInfo & fi )
Font info assignment.

int QFontInfo::pointSize () const
Returns the point size of the matched window system font.

See also QFont::pointSize().

bool QFontInfo::rawMode () const
Returns TRUE if the font is a raw mode font.

If it is a raw mode font, all other functions in QFontInfo will return the same values set in the QFont, regardless of the font actually used.

See also QFont::rawMode().

bool QFontInfo::strikeOut () const
Returns the strike out value of the matched window system font.

See also QFont::strikeOut().

QFont::StyleHint QFontInfo::styleHint() const
Returns the style of the matched window system font.

Currently only returns the hint set in QFont.

See also QFont::styleHint().

bool QFontInfo::underline () const
Returns the underline value of the matched window system font.

See also QFont::underline().

int QFontInfo::weight () const
Returns the weight of the matched window system font.

See also QFont::weight() and bold().

SEE ALSO
http://doc.trolltech.com/qfontinfo.html http://www.trolltech.com/faq/tech.html

COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

AUTHOR
Generated automatically from the source code.

BUGS
If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports make our job much simpler. Thank you.

In case of content or formattting problems with this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qfontinfo.3) and the Qt version (2.3.0).