PySide6.QtWidgets.QFontComboBox¶

class QFontComboBox¶

QFontComboBox 部件是一个组合框，允许用户选择字体家族。更多…

概要¶

属性¶

• currentFontᅟ - 当前选定的字体

• fontFiltersᅟ - 组合框的过滤器

• writingSystemᅟ - 作为组合框过滤器的书写系统

方法¶

• def __init__()

• def currentFont()

• def fontFilters()

• def sampleTextForFont()

• def sampleTextForSystem()

• def setDisplayFont()

• def setFontFilters()

• def setSampleTextForFont()

• def setSampleTextForSystem()

• def setWritingSystem()

• def writingSystem()

插槽¶

• def setCurrentFont()

信号¶

• def currentFontChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

组合框中填充了一个按字母顺序排列的字体家族名称列表，例如Arial、Helvetica和Times New Roman。家族名称尽可能使用实际字体显示。对于像Symbol这样的字体，其名称无法在字体本身中表示时，家族名称旁边会显示该字体的示例。

QFontComboBox 通常用于工具栏，与 QComboBox 一起用于控制字体大小，以及两个 QToolButton 用于加粗和斜体。

当用户选择新字体时，除了currentIndexChanged()外，还会发出currentFontChanged()信号。

调用 setWritingSystem() 来告诉 QFontComboBox 只显示支持给定书写系统的字体，并调用 setFontFilters() 来过滤掉某些类型的字体，例如非可缩放字体或等宽字体。

另请参阅

QComboBox QFontQFontInfoQFontMetricsQFontDatabase

class FontFilter¶

(继承自 enum.Flag) 此枚举可用于在字体组合框中仅显示特定类型的字体。

常量	描述
QFontComboBox.AllFonts	显示所有字体
QFontComboBox.ScalableFonts	显示可缩放的字体
QFontComboBox.NonScalableFonts	显示不可缩放的字体
QFontComboBox.MonospacedFonts	显示等宽字体
QFontComboBox.ProportionalFonts	显示比例字体

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property currentFontᅟ: QFont¶

此属性保存当前选定的字体。

另请参阅

currentIndex currentText

Access functions:

• currentFont()

• setCurrentFont()

• 信号 currentFontChanged()

property fontFiltersᅟ: Combination of QFontComboBox.FontFilter¶

此属性保存组合框的过滤器。

默认情况下，所有字体都会列出。

另请参阅

writingSystem

Access functions:

• fontFilters()

• setFontFilters()

property writingSystemᅟ: QFontDatabase.WritingSystem¶

此属性保存作为组合框过滤器的书写系统。

如果 script 是 QFontDatabase::Any（默认值），则列出所有字体。

另请参阅

fontFilters

Access functions:

• writingSystem()

• setWritingSystem()

__init__([parent=None])¶

Parameters:

父级 – QWidget

使用给定的parent构建一个字体组合框。

currentFont()¶

Return type:

QFont

另请参阅

setCurrentFont()

属性 currentFontᅟ 的获取器。

currentFontChanged(f)¶

Parameters:

f – QFont

每当当前字体发生变化时，都会发出此信号，并带有新的font。

另请参阅

currentFont

属性 currentFontᅟ 的通知信号。

fontFilters()¶

Return type:

FontFilter的组合

另请参阅

setFontFilters()

属性 fontFiltersᅟ 的获取器。

sampleTextForFont(fontFamily)¶

Parameters:

fontFamily – str

Return type:

字符串

返回在字体名称后显示的示例文本（当组合框打开时）用于给定的fontFamily。

另请参阅

setSampleTextForFont()

sampleTextForSystem(writingSystem)¶

Parameters:

writingSystem – WritingSystem

Return type:

字符串

返回给定writingSystem后显示的示例文本（当组合框打开时）。

另请参阅

setSampleTextForSystem()

setCurrentFont(f)¶

Parameters:

f – QFont

另请参阅

currentFont()

属性 currentFontᅟ 的设置器。

setDisplayFont(fontFamily, font)¶

Parameters:

• fontFamily – str

• 字体 – QFont

设置用于显示给定fontFamily的font（当组合框打开时）。

另请参阅

displayFont()

setFontFilters(filters)¶

Parameters:

filters – FontFilter 的组合

另请参阅

fontFilters()

属性 fontFiltersᅟ 的设置器。

setSampleTextForFont(fontFamily, sampleText)¶

Parameters:

• fontFamily – str

• sampleText – str

设置sampleText以在字体名称后显示（当组合框打开时）对于给定的fontFamily。

此函数提供的示例文本优先于使用setSampleTextForSystem()设置的文本。

另请参阅

sampleTextForFont()

setSampleTextForSystem(writingSystem, sampleText)¶

Parameters:

• writingSystem – WritingSystem

• sampleText – str

设置sampleText以在字体名称后显示（当组合框打开时）用于给定的writingSystem。

使用setSampleTextForFont()提供的示例文本具有优先权。

另请参阅

sampleTextForSystem()

setWritingSystem(arg__1)¶

Parameters:

arg__1 – WritingSystem

另请参阅

writingSystem()

属性 writingSystemᅟ 的设置器。

writingSystem()¶

Return type:

WritingSystem

另请参阅

setWritingSystem()

属性 writingSystemᅟ 的获取器。