PySide6.QtWidgets.QFontDialog¶

class QFontDialog¶

QFontDialog 类提供了一个用于选择字体的对话框部件。更多…

概要¶

属性¶

currentFontᅟ - 对话框的当前字体
optionsᅟ - 影响对话框外观和感觉的各种选项

注意

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

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

字体对话框是通过其中一个静态的getFont()函数创建的。

示例：

ok = bool()
font = QFontDialog.getFont(()
                ok, QFont("Helvetica [Cronyx]", 10), self)
if ok:
    # the user clicked OK and font is set to the font the user selected
else:
    # the user canceled the dialog; font is set to the initial
    # value, in this case Helvetica [Cronyx], 10

对话框也可以直接用于设置小部件的字体：

myWidget.setFont(QFontDialog.getFont(0, myWidget.font()))

如果用户点击确定，他们选择的字体将用于myWidget，如果他们点击取消，则使用原始字体。

另请参阅

QColorDialog QFileDialog 标准对话框示例

class FontDialogOption¶

(继承自 enum.Flag) 此枚举指定了影响字体对话框外观和感觉的各种选项。

例如，它允许指定应显示哪种类型的字体。如果未指定任何字体，则将列出所有可用的字体。

请注意，某些平台（例如Mac）可能不支持字体过滤选项。它们总是由非本地对话框（在Windows或Linux上使用）支持。

常量

描述

QFontDialog.NoButtons

不显示确定和取消按钮。（适用于“实时对话框”。）

QFontDialog.DontUseNativeDialog

在Mac上使用Qt的标准字体对话框，而不是Apple的原生字体面板。

QFontDialog.ScalableFonts

显示可缩放字体

QFontDialog.NonScalableFonts

显示不可缩放的字体

QFontDialog.MonospacedFonts

显示等宽字体

QFontDialog.ProportionalFonts

显示比例字体

另请参阅

options setOption() testOption()

常量	描述
QFontDialog.NoButtons	不显示确定和取消按钮。（适用于“实时对话框”。）
QFontDialog.DontUseNativeDialog	在Mac上使用Qt的标准字体对话框，而不是Apple的原生字体面板。
QFontDialog.ScalableFonts	显示可缩放字体
QFontDialog.NonScalableFonts	显示不可缩放的字体
QFontDialog.MonospacedFonts	显示等宽字体
QFontDialog.ProportionalFonts	显示比例字体

注意

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

property currentFontᅟ: QFont¶

此属性保存对话框的当前字体。

Access functions:

currentFont()
setCurrentFont()
信号 currentFontChanged()

property optionsᅟ: Combination of QFontDialog.FontDialogOption¶

此属性包含影响对话框外观和感觉的各种选项。

默认情况下，所有选项都被禁用。

选项应在显示对话框之前设置。在对话框可见时设置它们，不能保证立即对对话框产生影响（取决于选项和平台）。

另请参阅

setOption() testOption()

Access functions:

options()
setOptions()

__init__([parent=None])¶

Parameters:: 父级 – QWidget

构建一个标准字体对话框。

使用setCurrentFont()来设置初始字体属性。

parent 参数被传递给 QDialog 构造函数。

另请参阅

getFont()

__init__(initial[, parent=None])

Parameters:

initial – QFont
parent – QWidget

使用给定的parent和指定的initial字体构造一个标准字体对话框。

currentFont()¶

Return type:: QFont

返回当前字体。

另请参阅

setCurrentFont() selectedFont()

属性 currentFontᅟ 的获取器。

currentFontChanged(font)¶

Parameters:: 字体 – QFont

当当前字体更改时，会发出此信号。新字体在font中指定。

信号在用户选择字体时发出。最终，所选的字体可能与当前选择的字体不同。

另请参阅

currentFont fontSelected() selectedFont()

属性 currentFontᅟ 的通知信号。

fontSelected(font)¶

Parameters:: 字体 – QFont

当选择了一个字体时，会发出此信号。所选字体在font中指定。

信号仅在用户选择最终使用的字体时发出。当用户在字体对话框中更改当前字体时，不会发出信号。

另请参阅

selectedFont() currentFontChanged() currentFont

static getFont([parent=None])¶

Parameters:: 父级 – QWidget
Return type:: PyTuple

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

这是一个重载函数。

执行一个模态字体对话框并返回一个字体。

如果用户点击确定，则返回选定的字体。如果用户点击取消，则返回Qt默认字体。

对话框是用给定的parent构建的。如果ok参数不为空，则当用户点击确定时，其引用的值将设置为true，如果用户点击取消，则设置为false。

示例：

ok = bool()
font = QFontDialog.getFont(ok, self)
if ok:
    # font is set to the font the user selected
else:
    # the user canceled the dialog; font is set to the default
    # application font, QApplication::font()

static getFont(initial[, parent=None[, title=""[, options=QFontDialog.FontDialogOptions()]]])

Parameters:

initial – QFont
parent – QWidget
标题 – str
options – FontDialogOption 的组合

Return type:

PyTuple

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

执行一个模态字体对话框并返回一个字体。

如果用户点击确定，则返回选定的字体。如果用户点击取消，则返回初始字体。

对话框是用给定的parent和在options中指定的选项构建的。title显示为对话框的窗口标题，initial是初始选择的字体。如果ok参数不为空，则用户点击确定时，其引用的值设置为true，用户点击取消时设置为false。

示例：

ok = bool()
font = QFontDialog.getFont(ok, QFont("Times", 12), self)
if ok:
    # font is set to the font the user selected
else:
    # the user canceled the dialog; font is set to the initial
    # value, in this case Times, 12.

对话框也可以直接用于设置小部件的字体：

myWidget.setFont(QFontDialog.getFont(0, myWidget.font()))

在这个例子中，如果用户点击确定，他们将选择的字体将被使用，如果他们点击取消，则使用原始字体。

open(receiver, member)¶

Parameters:

receiver – QObject
member – str

打开对话框并将其fontSelected()信号连接到由receiver和member指定的槽。

当对话框关闭时，信号将从插槽断开。

options()¶

Return type:: FontDialogOption 的组合

另请参阅

setOptions()

属性 optionsᅟ 的获取器。

selectedFont()¶

Return type:: QFont

返回用户通过点击“确定”或等效按钮选择的字体。

注意

此字体并不总是与currentFont属性所持有的字体相同，因为用户可以在最终选择要使用的字体之前选择不同的字体。

setCurrentFont(font)¶

Parameters:: 字体 – QFont

将QFontDialog中高亮显示的字体设置为给定的font。

另请参阅

currentFont() selectedFont()

属性 currentFontᅟ 的设置器。

setOption(option[, on=true])¶

Parameters:

选项 – FontDialogOption
on – 布尔值

如果on为真，则启用给定的option；否则，清除给定的option。

另请参阅

options testOption()

setOptions(options)¶

Parameters:: options – FontDialogOption 的组合

另请参阅

options()

属性 optionsᅟ 的设置器。

testOption(option)¶

Parameters:: 选项 – FontDialogOption
Return type:: 布尔

如果给定的option已启用，则返回true；否则，返回false。

另请参阅

options setOption()

PySide6.QtWidgets.QFontDialog¶

概要¶

属性¶

方法¶

信号¶

静态函数¶

详细描述¶