The QFontInfo class provides general information about fonts. \inmodule QtGui. More...

#include <qfontinfo.h>

Public Member Functions
	QFontInfo (const QFont &)

	QFontInfo (const QFontInfo &)

	~QFontInfo ()

QFontInfo &	operator= (const QFontInfo &)

void	swap (QFontInfo &other) noexcept

QString	family () const

QString	styleName () const

int	pixelSize () const

int	pointSize () const

qreal	pointSizeF () const

bool	italic () const

QFont::Style	style () const

int	weight () const

bool	bold () const

bool	underline () const

bool	overline () const

bool	strikeOut () const

bool	fixedPitch () const

QFont::StyleHint	styleHint () const

bool	exactMatch () const

Detailed Description

The QFontInfo class provides general information about fonts. \inmodule QtGui.

\reentrant

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. \list 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.

(Note: 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.)

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.

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. \endlist

See also: QFont, QFontMetrics, QFontDatabase

Definition at line 50 of file qfontinfo.h.

Constructor & Destructor Documentation

◆ QFontInfo() [1/2]

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 \l{QWidget}{widgets} or \l{QPixmap}{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.

Definition at line 2574 of file qfont.cpp.

◆ QFontInfo() [2/2]

QFontInfo::QFontInfo ( const QFontInfo & fi )

Constructs a copy of fi.

Definition at line 2582 of file qfont.cpp.

◆ ~QFontInfo()

QFontInfo::~QFontInfo ( )

Destroys the font info object.

Definition at line 2590 of file qfont.cpp.

Member Function Documentation

◆ bold()

bool QFontInfo::bold ( ) const

inline

Returns true if weight() would return a value greater than QFont::Normal; otherwise returns false.

See also: weight(), QFont::bold()

Definition at line 69 of file qfontinfo.h.

◆ exactMatch()

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

Definition at line 2829 of file qfont.cpp.

Here is the call graph for this function:

◆ family()

QString QFontInfo::family ( ) const

Returns the family name of the matched window system font.

See also: QFont::family()

Definition at line 2616 of file qfont.cpp.

Here is the call graph for this function:

◆ fixedPitch()

bool QFontInfo::fixedPitch ( ) const

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

See also: QFont::fixedPitch()

Definition at line 2790 of file qfont.cpp.

Here is the call graph for this function:

◆ italic()

bool QFontInfo::italic ( ) const

Returns the italic value of the matched window system font.

See also: QFont::italic()

Definition at line 2679 of file qfont.cpp.

Here is the call graph for this function:

◆ operator=()

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

Assigns the font info in fi.

Definition at line 2597 of file qfont.cpp.

◆ overline()

bool QFontInfo::overline ( ) const

Returns the overline value of the matched window system font.

See also: QFont::overline()

Definition at line 2767 of file qfont.cpp.

◆ pixelSize()

int QFontInfo::pixelSize ( ) const

Returns the pixel size of the matched window system font.

See also: QFont::pointSize()

Definition at line 2667 of file qfont.cpp.

Here is the call graph for this function:

◆ pointSize()

int QFontInfo::pointSize ( ) const

Returns the point size of the matched window system font.

See also: pointSizeF(), QFont::pointSize()

Definition at line 2643 of file qfont.cpp.

Here is the call graph for this function:

◆ pointSizeF()

qreal QFontInfo::pointSizeF ( ) const

Returns the point size of the matched window system font.

See also: QFont::pointSizeF()

Definition at line 2655 of file qfont.cpp.

Here is the call graph for this function:

◆ strikeOut()

bool QFontInfo::strikeOut ( ) const

Returns the strikeout value of the matched window system font.

See also: QFont::strikeOut()

Definition at line 2780 of file qfont.cpp.

◆ style()

QFont::Style QFontInfo::style ( ) const

Returns the style value of the matched window system font.

See also: QFont::style()

Definition at line 2691 of file qfont.cpp.

Here is the call graph for this function:

◆ styleHint()

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(), QFont::StyleHint

Definition at line 2816 of file qfont.cpp.

Here is the call graph for this function:

◆ styleName()

QString QFontInfo::styleName ( ) const

Since: 4.8

Returns the style name of the matched window system font on systems that support it.

See also: QFont::styleName()

Definition at line 2631 of file qfont.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ swap()

void QFontInfo::swap ( QFontInfo & other )

inlinenoexcept

Since: 5.0

Swaps this font info instance with other. This function is very fast and never fails.

Definition at line 59 of file qfontinfo.h.

Here is the call graph for this function:

◆ underline()

bool QFontInfo::underline ( ) const

Returns the underline value of the matched window system font.

See also: QFont::underline()

Definition at line 2752 of file qfont.cpp.

◆ weight()

int QFontInfo::weight ( ) const

Returns the weight of the matched window system font.

See also: QFont::weight(), bold()

Definition at line 2725 of file qfont.cpp.

Here is the call graph for this function:

The documentation for this class was generated from the following files:

src/gui/text/qfontinfo.h
src/gui/text/qfont.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QFontInfo() [1/2]

◆ QFontInfo() [2/2]

◆ ~QFontInfo()

Member Function Documentation

◆ bold()

◆ exactMatch()

◆ family()

◆ fixedPitch()

◆ italic()

◆ operator=()

◆ overline()

◆ pixelSize()

◆ pointSize()

◆ pointSizeF()

◆ strikeOut()

◆ style()

◆ styleHint()

◆ styleName()

◆ swap()

◆ underline()

◆ weight()