class QFontComboBox

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

概要

属性

• currentFont - 当前选择的字体

• fontFilters - 组合框的过滤器

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

方法

• def __init__()

• def currentFont()

• def fontFilters()

• def sampleTextForFont()

• 定义 sampleTextForSystem()

• 定义 setDisplayFont()

• 定义 setFontFilters()

• 定义 setSampleTextForFont()

• 定义 setSampleTextForSystem()

• 定义 setWritingSystem()

• 定义 writingSystem()

槽函数

• 定义 setCurrentFont()

信号

• 定义 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

访问函数

• currentFont()

• setCurrentFont()

• 信号 currentFontChanged()

property fontFiltersᅟ: Combination of QFontComboBox.FontFilter

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

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

另请参阅

writingSystem

访问函数

• fontFilters()

• setFontFilters()

property writingSystemᅟ: QFontDatabase.WritingSystem

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

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

另请参阅

fontFilters

访问函数

• writingSystem()

• setWritingSystem()

__init__([parent=None])

参数：

parent – QWidget

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

currentFont()

返回类型：

QFont

另请参阅

setCurrentFont()

当前字体属性的获取器。

currentFontChanged(f)

参数：

f – QFont

当当前字体变化时，此信号被发射，新字体为 font。

另请参阅

currentFont

当前字体属性的通知信号。

fontFilters()

返回类型：

字体过滤器的组合。

另请参阅

setFontFilters()

fontFilters 属性的获取器。

sampleTextForFont(fontFamily)

参数：

fontFamily – 字符串

返回类型：

str

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

另请参阅

setSampleTextForFont()

sampleTextForSystem(writingSystem)

参数：

writingSystem – WritingSystem

返回类型：

str

为给定的 writingSystem 返回在字体名后面的显示文本（当组合框打开时）。

另请参阅

setSampleTextForSystem()

setCurrentFont(f)

参数：

f – QFont

另请参阅

currentFont()

当前字体属性的设置器。

setDisplayFont(fontFamily, font)

参数：

• fontFamily – 字符串

• font – QFont

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

另请参阅

displayFont()

setFontFilters(filters)

参数：

filters – FontFilter 的组合

另请参阅

fontFilters()

属性 fontFilters 的设置器。

setSampleTextForFont(fontFamily, sampleText)

参数：

• fontFamily – 字符串

• sampleText – 字符串

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

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

另请参阅

sampleTextForFont()

setSampleTextForSystem(writingSystem, sampleText)

参数：

• writingSystem – WritingSystem

• sampleText – 字符串

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

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

另请参阅

sampleTextForSystem()

setWritingSystem(arg__1)

参数：

arg__1 – WritingSystem

另请参阅

writingSystem()

属性 writingSystem 的设置器。

writingSystem()

返回类型：

WritingSystem

另请参阅

setWritingSystem()

属性 writingSystem 的获取器。