PySide6.QtWidgets.QFontComboBox

class QFontComboBox

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

PySide6.QtWidgets.QFontComboBox 的继承图

概要

属性

方法

插槽

信号

注意

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

详细描述

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

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

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

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

../../_images/windowsvista-fontcombobox.png

另请参阅

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:
property fontFiltersᅟ: Combination of QFontComboBox.FontFilter

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

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

另请参阅

writingSystem

Access functions:
property writingSystemᅟ: QFontDatabase.WritingSystem

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

如果 script 是 QFontDatabase::Any(默认值),则列出所有字体。

另请参阅

fontFilters

Access functions:
__init__([parent=None])
Parameters:

父级QWidget

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

currentFont()
Return type:

QFont

另请参阅

setCurrentFont()

属性 currentFontᅟ 的获取器。

currentFontChanged(f)
Parameters:

fQFont

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

另请参阅

currentFont

属性 currentFontᅟ 的通知信号。

fontFilters()
Return type:

FontFilter的组合

另请参阅

setFontFilters()

属性 fontFiltersᅟ 的获取器。

sampleTextForFont(fontFamily)
Parameters:

fontFamily – str

Return type:

字符串

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

另请参阅

setSampleTextForFont()

sampleTextForSystem(writingSystem)
Parameters:

writingSystemWritingSystem

Return type:

字符串

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

setCurrentFont(f)
Parameters:

fQFont

另请参阅

currentFont()

属性 currentFontᅟ 的设置器。

setDisplayFont(fontFamily, font)
Parameters:
  • fontFamily – str

  • 字体QFont

设置用于显示给定fontFamilyfont(当组合框打开时)。

另请参阅

displayFont()

setFontFilters(filters)
Parameters:

filtersFontFilter 的组合

另请参阅

fontFilters()

属性 fontFiltersᅟ 的设置器。

setSampleTextForFont(fontFamily, sampleText)
Parameters:
  • fontFamily – str

  • sampleText – str

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

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

另请参阅

sampleTextForFont()

setSampleTextForSystem(writingSystem, sampleText)
Parameters:

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

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

另请参阅

sampleTextForSystem()

setWritingSystem(arg__1)
Parameters:

arg__1WritingSystem

另请参阅

writingSystem()

属性 writingSystemᅟ 的设置器。

writingSystem()
Return type:

WritingSystem

另请参阅

setWritingSystem()

属性 writingSystemᅟ 的获取器。