From bd0f3345a938b35ce6a12f6150373b0955b8dd12 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 10 Jul 2011 15:24:15 -0500 Subject: Add Qt3 development HEAD version --- doc/html/qfontinfo.html | 191 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 191 insertions(+) create mode 100644 doc/html/qfontinfo.html (limited to 'doc/html/qfontinfo.html') diff --git a/doc/html/qfontinfo.html b/doc/html/qfontinfo.html new file mode 100644 index 0000000..9020ac8 --- /dev/null +++ b/doc/html/qfontinfo.html @@ -0,0 +1,191 @@ + + + + + +QFontInfo Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

QFontInfo Class Reference

+ +

The QFontInfo class provides general information about fonts. +More... +

#include <qfontinfo.h> +

List of all member functions. +

Public Members

+ +

Detailed Description

+ + +

The QFontInfo class provides general information about fonts. +

+ +

The QFontInfo class provides the same access functions as QFont, +e.g. family(), pointSize(), italic(), weight(), fixedPitch(), +styleHint() etc. But whilst the QFont access functions return the +values that were set, a QFontInfo object returns the values that +apply to the font that will actually be used to draw the text. +

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

There are three ways to create a QFontInfo object. +

    +
  1. Calling the QFontInfo constructor with a QFont creates a font +info object for a screen-compatible font, i.e. the font cannot be +a printer font*. If the font is changed later, the font +info object is not updated. +

  2. QWidget::fontInfo() returns the font info for a widget's font. +This is equivalent to calling QFontInfo(widget->font()). If the +widget's font is changed later, the font info object is not +updated. +

  3. QPainter::fontInfo() returns the font info for a painter's +current font. If the painter's font is changed later, the font +info object is not updated. +
+

* If you use a printer font the values returned may be +inaccurate. Printer fonts are not always accessible so the nearest +screen font is used if a printer font is supplied. +

See also QFont, QFontMetrics, QFontDatabase, Graphics Classes, and Implicitly and Explicitly Shared Classes. + +

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, not QPicture or QPrinter. +

The font info object holds the information for the font that is +passed in the constructor at the time it is created, and is not +updated if the font's attributes are changed later. +

Use QPainter::fontInfo() to get the font info when painting. +This will give correct results also when painting on paint device +that is not screen-compatible. + +

QFontInfo::QFontInfo ( const QFont & font, QFont::Script script ) +

+Constructs a font info object for font using the specified script. + +

QFontInfo::QFontInfo ( const QFontInfo & fi ) +

+Constructs a copy of fi. + +

QFontInfo::~QFontInfo () +

+Destroys the font info object. + +

bool QFontInfo::bold () const +

+ +

Returns TRUE if weight() would return a value greater than QFont::Normal; otherwise returns FALSE. +

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

Example: qfd/fontdisplayer.cpp. +

bool QFontInfo::exactMatch () const +

+Returns TRUE if the matched window system font is exactly the same +as the one specified by the font; otherwise returns FALSE. +

See also QFont::exactMatch(). + +

QString QFontInfo::family () const +

+Returns the family name of the matched window system font. +

See also QFont::family(). + +

Examples: fonts/simple-qfont-demo/viewer.cpp and qfd/fontdisplayer.cpp. +

bool QFontInfo::fixedPitch () const +

+Returns the fixed pitch value of the matched window system font. +

See also QFont::fixedPitch(). + +

bool QFontInfo::italic () const +

+Returns the italic value of the matched window system font. +

See also QFont::italic(). + +

Example: qfd/fontdisplayer.cpp. +

QFontInfo & QFontInfo::operator= ( const QFontInfo & fi ) +

+Assigns the font info in fi. + +

int QFontInfo::pixelSize () const +

+Returns the pixel size of the matched window system font. +

See also QFont::pointSize(). + +

int QFontInfo::pointSize () const +

+Returns the point size of the matched window system font. +

See also QFont::pointSize(). + +

Examples: fonts/simple-qfont-demo/viewer.cpp and qfd/fontdisplayer.cpp. +

bool QFontInfo::rawMode () const +

+Returns TRUE if the font is a raw mode font; otherwise returns +FALSE. +

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(). + +

QFont::StyleHint QFontInfo::styleHint () const +

+Returns the style of the matched window system font. +

Currently only returns the style hint set in QFont. +

See also QFont::styleHint() and QFont::StyleHint. + +

int QFontInfo::weight () const +

+Returns the weight of the matched window system font. +

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

+This file is part of the Qt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
Qt 3.3.8
+
+ -- cgit v1.2.1