QgsFontUtils Class Reference

#include <qgsfontutils.h>

Static Public Member Functions
static bool	fontMatchOnSystem (const QFont &f)
	Check whether exact font is on system.
static bool	fontFamilyOnSystem (const QString &family)
	Check whether font family is on system in a quick manner, which does not compare [foundry].
static bool	fontFamilyHasStyle (const QString &family, const QString &style)
	Check whether font family on system has specific style.
static bool	fontFamilyMatchOnSystem (const QString &family, QString *chosen=0, bool *match=0)
	Check whether font family is on system.
static bool	updateFontViaStyle (QFont &f, const QString &fontstyle, bool fallback=false)
	Updates font with named style and retain all font properties.
static QString	standardTestFontFamily ()
	Get standard test font family.
static bool	loadStandardTestFonts (QStringList loadstyles)
	Loads standard test fonts from filesystem or qrc resource.
static QFont	getStandardTestFont (const QString &style="Roman", int pointsize=12)
	Get standard test font with specific style.

Detailed Description

Definition at line 22 of file qgsfontutils.h.

Member Function Documentation

bool QgsFontUtils::fontFamilyHasStyle ( const QString &  family, const QString &  style  )

static

Check whether font family on system has specific style.

Parameters

family	The family to test
style	The style to test for

Returns

Whether family has style

Note

Added in QGIS 2.1

Definition at line 42 of file qgsfontutils.cpp.

References fontFamilyOnSystem().

Referenced by getStandardTestFont(), loadStandardTestFonts(), and updateFontViaStyle().

bool QgsFontUtils::fontFamilyMatchOnSystem ( const QString &  family, QString *  chosen = 0, bool *  match = 0  )

static

Check whether font family is on system.

Parameters

family	The family to test
chosen	The actual family (possibly from different foundry) returned by system
match	Whether the family [foundry] returned by system is a match

Returns

Whether family was found on system

Definition at line 48 of file qgsfontutils.cpp.

Referenced by QgsPalLayerSettings::readFromLayer().

bool QgsFontUtils::fontFamilyOnSystem ( const QString &  family )

static

Check whether font family is on system in a quick manner, which does not compare [foundry].

Parameters

family

The family to test

Returns

Whether family was found on system

Note

This is good for use in loops of large lists, e.g. registering many features for labeling

Definition at line 35 of file qgsfontutils.cpp.

Referenced by fontFamilyHasStyle(), and QgsPalLayerSettings::parseTextStyle().

bool QgsFontUtils::fontMatchOnSystem ( const QFont &  f )

static

Check whether exact font is on system.

Parameters

f	The font to test for match

Definition at line 29 of file qgsfontutils.cpp.

QFont QgsFontUtils::getStandardTestFont ( const QString &  style = "Roman", int  pointsize = 12  )

static

Get standard test font with specific style.

Parameters

style	Style to load, e.g. Roman, Oblique, Bold, Bold Oblique
pointsize	Font point size to set

Returns

QFont

Note

Added in QGIS 2.1

Definition at line 265 of file qgsfontutils.cpp.

References fontFamilyHasStyle(), loadStandardTestFonts(), and standardTestFontFamily().

bool QgsFontUtils::loadStandardTestFonts ( QStringList  loadstyles )

static

Loads standard test fonts from filesystem or qrc resource.

Parameters

loadstyles

List of styles to load, e.g. All, Roman, Oblique, Bold, Bold Oblique

Returns

Whether any font was loaded

Note

Done by default on debug app/server startup to ensure fonts available for unit tests (Roman and Bold)

Added in QGIS 2.1

Definition at line 203 of file qgsfontutils.cpp.

References QgsApplication::buildSourcePath(), fontFamilyHasStyle(), QgsApplication::isRunningFromBuildDir(), QgsDebugMsg, and standardTestFontFamily().

Referenced by getStandardTestFont().

QString QgsFontUtils::standardTestFontFamily ( )

static

Get standard test font family.

Note

Added in QGIS 2.1

Definition at line 198 of file qgsfontutils.cpp.

Referenced by getStandardTestFont(), and loadStandardTestFonts().

bool QgsFontUtils::updateFontViaStyle ( QFont &  f, const QString &  fontstyle, bool  fallback = false  )

static

Updates font with named style and retain all font properties.

Parameters

f	The font to update
fontstyle	The style to try and switch the font to
fallback	If no matching fontstyle found for font, assign most similar or first style found to font

Returns

Whether the font was updated (also returns true if the requested style matches font's current style)

Note

This is a more featured replacement for a Qt 4.8+ function: void QFont::setStyleName ( const QString & styleName )

Definition at line 101 of file qgsfontutils.cpp.

References fontFamilyHasStyle().

Referenced by QgsPalLayerSettings::parseTextStyle(), and QgsPalLayerSettings::readFromLayer().

---

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

• /tmp/buildd/qgis-2.2.0+wheezy1/src/core/qgsfontutils.h
• /tmp/buildd/qgis-2.2.0+wheezy1/src/core/qgsfontutils.cpp