Home · All Classes · Modules

QFontComboBox Class Reference
[QtGui module]

The QFontComboBox widget is a combobox that lets the user select a font family. More...

Inherits QComboBox.



Qt Signals

Detailed Description

The QFontComboBox widget is a combobox that lets the user select a font family.

The combobox is populated with an alphabetized list of font family names, such as Arial, Helvetica, and Times New Roman. Family names are displayed using the actual font when possible. For fonts such as Symbol, where the name is not representable in the font itself, a sample of the font is displayed next to the family name.

QFontComboBox is often used in toolbars, in conjunction with a QComboBox for controlling the font size and two QToolButtons for bold and italic.

When the user selects a new font, the currentFontChanged() signal is emitted in addition to currentIndexChanged().

Call setWritingSystem() to tell QFontComboBox to show only fonts that support a given writing system, and setFontFilters() to filter out certain types of fonts as e.g. non scalable fonts or monospaced fonts.

Screenshot of QFontComboBox on Windows XP

Type Documentation


This enum can be used to only show certain types of fonts in the font combo box.

Constant Value Description
QFontComboBox.AllFonts 0 Show all fonts
QFontComboBox.ScalableFonts 0x1 Show scalable fonts
QFontComboBox.NonScalableFonts 0x2 Show non scalable fonts
QFontComboBox.MonospacedFonts 0x4 Show monospaced fonts
QFontComboBox.ProportionalFonts 0x8 Show proportional fonts

The FontFilters type is a typedef for QFlags<FontFilter>. It stores an OR combination of FontFilter values.

Method Documentation

QFontComboBox.__init__ (self, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a font combobox with the given parent.

QFont QFontComboBox.currentFont (self)

bool QFontComboBox.event (self, QEvent e)

Reimplemented from QObject.event().

FontFilters QFontComboBox.fontFilters (self)

QFontComboBox.setCurrentFont (self, QFont f)

This method is also a Qt slot with the C++ signature void setCurrentFont(const ::QFont&).

QFontComboBox.setFontFilters (self, FontFilters filters)

QFontComboBox.setWritingSystem (self, QFontDatabase.WritingSystem)

QSize QFontComboBox.sizeHint (self)

Reimplemented from QWidget.sizeHint().

QFontDatabase.WritingSystem QFontComboBox.writingSystem (self)

Qt Signal Documentation

void currentFontChanged (const ::QFont&)

This is the default overload of this signal.

This signal is emitted whenever the current font changes, with the new font.

See also currentFont.

PyQt 4.12 for X11Copyright © Riverbank Computing Ltd and The Qt Company 2015Qt 4.8.7