\reentrant More...

#include <qfontinfo.h>

Collaboration diagram for QFontInfo:

Public Member Functions
	QFontInfo (const QFont &)
	Constructs a font info object for font.
	QFontInfo (const QFontInfo &)
	Constructs a copy of fi.
	~QFontInfo ()
	Destroys the font info object.
QFontInfo &	operator= (const QFontInfo &)
	Assigns the font info in fi.
void	swap (QFontInfo &other) noexcept
QString	family () const
	Returns the family name of the matched window system font.
QString	styleName () const
int	pixelSize () const
	Returns the pixel size of the matched window system font.
int	pointSize () const
	Returns the point size of the matched window system font.
qreal	pointSizeF () const
	Returns the point size of the matched window system font.
bool	italic () const
	Returns the italic value of the matched window system font.
QFont::Style	style () const
	Returns the style value of the matched window system font.
int	weight () const
	Returns the weight of the matched window system font.
bool	bold () const
	Returns `true` if weight() would return a value greater than QFont::Normal; otherwise returns `false`.
bool	underline () const
	Returns the underline value of the matched window system font.
bool	overline () const
	Returns the overline value of the matched window system font.
bool	strikeOut () const
	Returns the strikeout value of the matched window system font.
bool	fixedPitch () const
	Returns the fixed pitch value of the matched window system font.
QFont::StyleHint	styleHint () const
	Returns the style of the matched window system font.
QList< QFontVariableAxis >	variableAxes () const
bool	exactMatch () const
	Returns `true` if the matched window system font is exactly the same as the one specified by the font; otherwise returns `false`.

Detailed Description

\reentrant

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

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

Definition at line 16 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.

See also: {Checking for the existence of a font}

Definition at line 3081 of file qfont.cpp.

◆ QFontInfo() [2/2]

QFontInfo::QFontInfo ( const QFontInfo & fi )

Constructs a copy of fi.

Definition at line 3089 of file qfont.cpp.

◆ ~QFontInfo()

QFontInfo::~QFontInfo ( )

Destroys the font info object.

Definition at line 3097 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 35 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 3334 of file qfont.cpp.

◆ family()

QString QFontInfo::family ( ) const

Returns the family name of the matched window system font.

See also: QFont::family(), {Checking for the existence of a font}

Definition at line 3121 of file qfont.cpp.

◆ fixedPitch()

bool QFontInfo::fixedPitch ( ) const

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

See also: QFont::fixedPitch()

Definition at line 3295 of file qfont.cpp.

◆ italic()

bool QFontInfo::italic ( ) const

Returns the italic value of the matched window system font.

See also: QFont::italic()

Definition at line 3184 of file qfont.cpp.

◆ operator=()

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

Assigns the font info in fi.

Definition at line 3104 of file qfont.cpp.

◆ overline()

bool QFontInfo::overline ( ) const

Returns the overline value of the matched window system font.

See also: QFont::overline()

Here we read the overline flag directly from the QFont. This is OK for X11 and for Windows because we always get what we want.

Definition at line 3272 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 3172 of file qfont.cpp.

◆ pointSize()

int QFontInfo::pointSize ( ) const

Returns the point size of the matched window system font.

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

Definition at line 3148 of file qfont.cpp.

◆ pointSizeF()

qreal QFontInfo::pointSizeF ( ) const

Returns the point size of the matched window system font.

See also: QFont::pointSizeF()

Definition at line 3160 of file qfont.cpp.

◆ strikeOut()

bool QFontInfo::strikeOut ( ) const

Returns the strikeout value of the matched window system font.

See also: QFont::strikeOut()

Here we read the strikeOut flag directly from the QFont. This is OK for X11 and for Windows because we always get what we want.

Definition at line 3285 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 3196 of file qfont.cpp.

◆ 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 3321 of file qfont.cpp.

◆ 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 3136 of file qfont.cpp.

◆ swap()

void QFontInfo::swap ( QFontInfo & other )

inlinenoexcept

Since: 5.0 \memberswap{font info instance}

Definition at line 25 of file qfontinfo.h.

◆ underline()

bool QFontInfo::underline ( ) const

Returns the underline value of the matched window system font.

See also: QFont::underline()

Here we read the underline flag directly from the QFont. This is OK for X11 and for Windows because we always get what we want.

Definition at line 3257 of file qfont.cpp.

◆ variableAxes()

QList< QFontVariableAxis > QFontInfo::variableAxes ( ) const

Since: 6.9

If the font is a variable font, this function will return the list of axes the font supports.

See \l{QFont::}{setVariableAxis()} for more details on variable axes.

Definition at line 3349 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 3230 of file qfont.cpp.

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

qtbase/src/gui/text/qfontinfo.h (cc128d802c6d9c87a1e00a8a88d5e6590a7195f4)
qtbase/src/gui/text/qfont.cpp (4c67231bc0e03319c0e1e049f1ef0ec2ba73aa3f)

Public Member Functions