QFontDatabase¶

The QFontDatabase class provides information about the fonts available in the underlying window system. More…

Synopsis¶

Static functions¶

def addApplicationFont (fileName)
def addApplicationFontFromData (fontData)
def applicationFontFamilies (id)
def bold (family, style)
def families ([writingSystem=QFontDatabase.WritingSystem.Any])
def font (family, style, pointSize)
def hasFamily (family)
def isBitmapScalable (family[, style=””])
def isFixedPitch (family[, style=””])
def isPrivateFamily (family)
def isScalable (family[, style=””])
def isSmoothlyScalable (family[, style=””])
def italic (family, style)
def pointSizes (family[, style=””])
def removeAllApplicationFonts ()
def removeApplicationFont (id)
def smoothSizes (family, style)
def standardSizes ()
def styleString (font)
def styleString (fontInfo)
def styles (family)
def systemFont (type)
def weight (family, style)
def writingSystemName (writingSystem)
def writingSystemSample (writingSystem)
def writingSystems ()
def writingSystems (family)

Detailed Description¶

The most common uses of this class are to query the database for the list of font families() and for the pointSizes() and styles() that are available for each family. An alternative to pointSizes() is smoothSizes() which returns the sizes at which a given family and style will look attractive.

If the font family is available from two or more foundries the foundry name is included in the family name; for example: “Helvetica [Adobe]” and “Helvetica [Cronyx]”. When you specify a family, you can either use the old hyphenated “foundry-family” format or the bracketed “family [foundry]” format; for example: “Cronyx-Helvetica” or “Helvetica [Cronyx]”. If the family has a foundry it is always returned using the bracketed format, as is the case with the value returned by families() .

The font() function returns a QFont given a family, style and point size.

A family and style combination can be checked to see if it is italic() or bold() , and to retrieve its weight() . Similarly we can call isBitmapScalable() , isSmoothlyScalable() , isScalable() and isFixedPitch() .

Use the styleString() to obtain a text version of a style.

The QFontDatabase class provides some helper functions, for example, standardSizes() . You can retrieve the description of a writing system using writingSystemName() , and a sample of characters in a writing system with writingSystemSample() .

Example:

fontTree = QTreeWidget()
fontTree.setColumnCount(2)
fontTree.setHeaderLabels(QStringList() << "Font" << "Smooth Sizes")
fontFamilies = QFontDatabase.families()
for family in fontFamilies:
    familyItem = QTreeWidgetItem(fontTree)
    familyItem.setText(0, family)
    fontStyles = QFontDatabase.styles(family)
    for style in fontStyles:
        styleItem = QTreeWidgetItem(familyItem)
        styleItem.setText(0, style)
        sizes = QString()
        smoothSizes = QFontDatabase.smoothSizes(family, style)
        for points in smoothSizes:
            sizes += QString.number(points) + ' '
        styleItem.setText(1, sizes.trimmed())

This example gets the list of font families, the list of styles for each family, and the point sizes that are available for each combination of family and style, displaying this information in a tree view.

See also

QFont QFontInfo QFontMetrics Character Map Example

class PySide6.QtGui.QFontDatabase¶

Note

This constructor is deprecated.

PySide6.QtGui.QFontDatabase(QFontDatabase)

Parameters: QFontDatabase – PySide6.QtGui.QFontDatabase

Call the class methods as static functions instead.

Creates a font database object.

PySide6.QtGui.QFontDatabase.WritingSystem¶

Constant	Description
QFontDatabase.Any
QFontDatabase.Latin
QFontDatabase.Greek
QFontDatabase.Cyrillic
QFontDatabase.Armenian
QFontDatabase.Hebrew
QFontDatabase.Arabic
QFontDatabase.Syriac
QFontDatabase.Thaana
QFontDatabase.Devanagari
QFontDatabase.Bengali
QFontDatabase.Gurmukhi
QFontDatabase.Gujarati
QFontDatabase.Oriya
QFontDatabase.Tamil
QFontDatabase.Telugu
QFontDatabase.Kannada
QFontDatabase.Malayalam
QFontDatabase.Sinhala
QFontDatabase.Thai
QFontDatabase.Lao
QFontDatabase.Tibetan
QFontDatabase.Myanmar
QFontDatabase.Georgian
QFontDatabase.Khmer
QFontDatabase.SimplifiedChinese
QFontDatabase.TraditionalChinese
QFontDatabase.Japanese
QFontDatabase.Korean
QFontDatabase.Vietnamese
QFontDatabase.Symbol
QFontDatabase.Other	(the same as Symbol)
QFontDatabase.Ogham
QFontDatabase.Runic
QFontDatabase.Nko

PySide6.QtGui.QFontDatabase.SystemFont¶

Constant	Description
QFontDatabase.GeneralFont	The default system font.
QFontDatabase.FixedFont	The fixed font that the system recommends.
QFontDatabase.TitleFont	The system standard font for titles.
QFontDatabase.SmallestReadableFont	The smallest readable system font.

static PySide6.QtGui.QFontDatabase.addApplicationFont(fileName)¶

Parameters: fileName – str
Return type: int

Loads the font from the file specified by fileName and makes it available to the application. An ID is returned that can be used to remove the font again with removeApplicationFont() or to retrieve the list of family names contained in the font.

The function returns -1 if the font could not be loaded.

Currently only TrueType fonts, TrueType font collections, and OpenType fonts are supported.

Note

Adding application fonts on Unix/X11 platforms without fontconfig is currently not supported.

Table of Contents

Previous topic

Next topic

QFontDatabase¶

Synopsis¶

Static functions¶

Detailed Description¶