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

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 15 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 3052 of file qfont.cpp.

◆ QFontInfo() [2/2]

QFontInfo::QFontInfo ( const QFontInfo & fi )

Constructs a copy of fi.

Definition at line 3060 of file qfont.cpp.

◆ ~QFontInfo()

QFontInfo::~QFontInfo ( )

Destroys the font info object.

Definition at line 3068 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 34 of file qfontinfo.h.

References QFont::Normal.

Referenced by QTextMarkdownWriter::writeBlock().

Here is the caller graph for this function:

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

References engine, QFontPrivate::engineForScript(), QFontDef::exactMatch(), Q_ASSERT, and QFontPrivate::request.

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(), {Checking for the existence of a font}

Definition at line 3094 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QQuickTextPrivate::setupTextLayout(), and QQuickText::updatePolish().

Here is the call graph for this function:

Here is the caller 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 3268 of file qfont.cpp.

References ch, engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QTextMarkdownWriter::writeBlock().

Here is the call graph for this function:

Here is the caller 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 3157 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), Q_ASSERT, and QFont::StyleNormal.

Referenced by QQuickTextPrivate::setupTextLayout(), and QTextMarkdownWriter::writeBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator=()

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

Assigns the font info in fi.

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

References QFontPrivate::overline.

◆ pixelSize()

int QFontInfo::pixelSize ( ) const

Returns the pixel size of the matched window system font.

See also: QFont::pointSize()

Definition at line 3145 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QQuickTextPrivate::setupTextLayout().

Here is the call graph for this function:

Here is the caller 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 3121 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), Q_ASSERT, and qRound().

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

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QQC2_NAMESPACE::QMacStyle::drawControl(), QMacStyle::drawControl(), qt_fontToString(), and QQuickTextPrivate::setupTextLayout().

Here is the call graph for this function:

Here is the caller graph for this function:

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

References QFontPrivate::strikeOut.

Referenced by QTextMarkdownWriter::writeBlock().

Here is the caller graph for this function:

◆ style()

QFont::Style QFontInfo::style ( ) const

Returns the style value of the matched window system font.

See also: QFont::style()

Definition at line 3169 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QFontDatabase::styleString().

Here is the call graph for this function:

Here is the caller 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 3294 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

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

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QQuickTextPrivate::setupTextLayout(), and QFontDatabase::styleString().

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 24 of file qfontinfo.h.

References d, and other().

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

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

References QFontPrivate::underline.

Referenced by QTextMarkdownWriter::writeBlock().

Here is the caller graph for this function:

◆ weight()

int QFontInfo::weight ( ) const

Returns the weight of the matched window system font.

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

Definition at line 3203 of file qfont.cpp.

References engine, QFontPrivate::engineForScript(), and Q_ASSERT.

Referenced by QQuickTextPrivate::setupTextLayout(), and QFontDatabase::styleString().

Here is the call graph for this function:

Here is the caller graph for this function:

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

qtbase/src/gui/text/qfontinfo.h (314d86335ddd3ba8f67267c0e25b4df5fe0419c3)
qtbase/src/gui/text/qfont.cpp (1593b1f6d610ce9bdb9dff4104f7f447e03a9585)

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