KFontUtils Namespace Reference

Enumerations
enum	AdaptFontSizeOption { NoFlags = 0x01, DoNotAllowWordWrap = 0x02 }
Functions
qreal	adaptFontSize (QPainter &painter, const QString &text, qreal width, qreal height, qreal maxFontSize=28.0, qreal minFontSize=1.0, AdaptFontSizeOptions flags=NoFlags)
qreal	adaptFontSize (QPainter &painter, const QString &text, const QSizeF &availableSize, qreal maxFontSize=28.0, qreal minFontSize=1.0, AdaptFontSizeOptions flags=NoFlags)

---

Enumeration Type Documentation

enum KFontUtils::AdaptFontSizeOption

Modifiers for the adaptFontSize function.

Enumerator:

NoFlags
DoNotAllowWordWrap

Definition at line 35 of file kfontutils.h.

---

Function Documentation

qreal KFontUtils::adaptFontSize	(	QPainter &	painter,
		const QString &	text,
		qreal	width,
		qreal	height,
		qreal	maxFontSize = 28.0,
		qreal	minFontSize = 1.0,
		AdaptFontSizeOptions	flags = NoFlags
	)

Helper function that calculates the biggest font size (in points) used drawing a centered text using word wrapping.

Parameters:

painter	The painter where the text will be painted. The font set in the painter is used for the calculation. Note the painter font size is modified by this call
text	The text you want to draw
width	The available width for drawing
height	The available height for drawing
maxFontSize	The maximum font size (in points) to consider
minFontSize	The minimum font size (in points) to consider
flags	The modifiers for how the text is painted

Returns:

The calculated biggest font size (in points) that draws the text in the given dimensions. Can return smaller than minFontSize, that means the text doesn't fit in the given rectangle. Can return -1 on error

Since:

KDE 4.7

Definition at line 27 of file kfontutils.cpp.

qreal KFontUtils::adaptFontSize	(	QPainter &	painter,
		const QString &	text,
		const QSizeF &	availableSize,
		qreal	maxFontSize = 28.0,
		qreal	minFontSize = 1.0,
		AdaptFontSizeOptions	flags = NoFlags
	)

Convenience function for adaptFontSize that accepts a QSizeF instead two qreals.

Since:

KDE 4.7

Definition at line 54 of file kfontutils.cpp.