QFontComboBox#
The QFontComboBox
widget is a combobox that lets the user select a font family. More…
Synopsis#
Functions#
def
currentFont
()def
fontFilters
()def
sampleTextForFont
(fontFamily)def
sampleTextForSystem
(writingSystem)def
setDisplayFont
(fontFamily, font)def
setFontFilters
(filters)def
setSampleTextForFont
(fontFamily, sampleText)def
setSampleTextForSystem
(writingSystem, sampleText)def
setWritingSystem
(arg__1)def
writingSystem
()
Slots#
def
setCurrentFont
(f)
Signals#
def
currentFontChanged
(f)
Detailed Description#
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 QToolButton
s 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.
![]()
See also
QComboBox
QFont
QFontInfo
QFontMetrics
QFontDatabase
Character Map Example
- class PySide6.QtWidgets.QFontComboBox([parent=None])#
- Parameters
parent –
PySide6.QtWidgets.QWidget
Constructs a font combobox with the given parent
.
- PySide6.QtWidgets.QFontComboBox.FontFilter#
(inherits enum.Flag
) This enum can be used to only show certain types of fonts in the font combo box.
Constant
Description
QFontComboBox.AllFonts
Show all fonts
QFontComboBox.ScalableFonts
Show scalable fonts
QFontComboBox.NonScalableFonts
Show non scalable fonts
QFontComboBox.MonospacedFonts
Show monospaced fonts
QFontComboBox.ProportionalFonts
Show proportional fonts
- PySide6.QtWidgets.QFontComboBox.currentFont()#
- Return type
This property holds the currently selected font.
See also
- PySide6.QtWidgets.QFontComboBox.currentFontChanged(f)#
- Parameters
This signal is emitted whenever the current font changes, with the new font
.
See also
- PySide6.QtWidgets.QFontComboBox.fontFilters()#
- Return type
FontFilters
This property holds the filter for the combobox.
By default, all fonts are listed.
See also
- PySide6.QtWidgets.QFontComboBox.sampleTextForFont(fontFamily)#
- Parameters
fontFamily – str
- Return type
str
Returns the sample text to show after the font name (when the combo is open) for a given fontFamily
.
See also
- PySide6.QtWidgets.QFontComboBox.sampleTextForSystem(writingSystem)#
- Parameters
writingSystem –
WritingSystem
- Return type
str
Returns the sample text to show after the font name (when the combo is open) for a given writingSystem
.
See also
- PySide6.QtWidgets.QFontComboBox.setCurrentFont(f)#
- Parameters
This property holds the currently selected font.
See also
- PySide6.QtWidgets.QFontComboBox.setDisplayFont(fontFamily, font)#
- Parameters
fontFamily – str
font –
PySide6.QtGui.QFont
Sets the font
to be used to display a given fontFamily
(when the combo is open).
See also
displayFont()
- PySide6.QtWidgets.QFontComboBox.setFontFilters(filters)#
- Parameters
filters –
FontFilters
This property holds the filter for the combobox.
By default, all fonts are listed.
See also
- PySide6.QtWidgets.QFontComboBox.setSampleTextForFont(fontFamily, sampleText)#
- Parameters
fontFamily – str
sampleText – str
Sets the sampleText
to show after the font name (when the combo is open) for a given fontFamily
.
The sample text given with this function has priority over the one set with setSampleTextForSystem()
.
See also
- PySide6.QtWidgets.QFontComboBox.setSampleTextForSystem(writingSystem, sampleText)#
- Parameters
writingSystem –
WritingSystem
sampleText – str
Sets the sampleText
to show after the font name (when the combo is open) for a given writingSystem
.
The sample text given with setSampleTextForFont()
has priority.
See also
- PySide6.QtWidgets.QFontComboBox.setWritingSystem(arg__1)#
- Parameters
arg__1 –
WritingSystem
This property holds the writing system that serves as a filter for the combobox.
If script
is Any
(the default), all fonts are listed.
See also
- PySide6.QtWidgets.QFontComboBox.writingSystem()#
- Return type
This property holds the writing system that serves as a filter for the combobox.
If script
is Any
(the default), all fonts are listed.
See also