class QFontDialog#

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

概要#

属性#

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

方法#

def __init__()
def currentFont()
def open()
def options()
def selectedFont()
def setCurrentFont()
def setOption()
def setOptions()
def testOption()

信号#

def currentFontChanged()
def fontSelected()

静态函数#

def getFont()

注释

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

详细描述#

警告

本节包含自动从 C++ 转换为 Python 的代码片段，可能存在错误。

通过静态 getFont() 函数之一创建字体对话框。

Examples

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 时，可以直接使用属性，否则通过访问函数使用。

属性 currentFont: QFont#

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

访问函数

currentFont()
setCurrentFont()
信号 currentFontChanged()

属性 options: QFontDialog.FontDialogOption 的组合#

此属性保存了影响对话框外观和感觉的各种选项。

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

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

另请参阅

setOption() testOption()

访问函数

options()
setOptions()

__init__([parent=None])#

参数:: parent – QWidget

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

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

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

另请参阅

getFont()

__init__(initial[, parent=None])

参数:

initial – QFont
parent – QWidget

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

currentFont()#

返回类型:: QFont

返回当前字体。

另请参阅

setCurrentFont() selectedFont()

是属性 currentFont 的 getter 。

currentFontChanged(font)#

参数:: font – QFont

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

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

另请参阅

currentFont fontSelected() selectedFont()

属性currentFont的通知信号。

fontSelected(font)#

参数:: font – QFont

当选择字体时发出此信号。所选的字体在font中指定。

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

另请参阅

selectedFont() currentFontChanged() currentFont

静态 getFont([parent=None])#

参数:: parent – QWidget
返回类型:: 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()

警告

不要在对话框执行期间删除parent。如果您想要这样做，您应该使用其中一个QFontDialog构造函数自行创建对话框。

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

参数:

initial – QFont
parent – QWidget
标题 – 字符串
选项 – FontDialogOption 的组合

返回类型:

PyTuple

警告

本节包含自动从 C++ 转换为 Python 的代码片段，可能存在错误。

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

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

对话框使用指定的 parent 和 options 中指定的选项进行构建。title 显示为对话框的窗口标题，initial 是初始选定的字体。如果 ok 参数不为空，则用户点击“确定”时将其设置为真，用户点击“取消”时设置为假。

Examples

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()))

在此示例中，如果用户点击“确定”，将使用用户选择的字体，如果他们点击“取消”，则使用原始字体。

警告

不要在对话框执行期间删除parent。如果您想要这样做，您应该使用其中一个QFontDialog构造函数自行创建对话框。

open(receiver, member)

参数:

receiver – QObject
member – 字符串

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

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

options()

返回类型:: FontDialogOption 的组合

另请参阅

setOptions()

options 属性的获取器

selectedFont()

返回类型:: QFont

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

注释

此字体不一定与 currentFont 属性所拥有的字体相同，因为用户可以在最终选择使用之前选择不同的字体。

setCurrentFont(font)

参数:: font – QFont

设置在QFontDialog中高亮的字体为给定的font。

另请参阅

currentFont() selectedFont()

属性currentFontᅟ的设置器。

setOption(option[, on=true])#

参数:

option – FontDialogOption
on – 布尔值

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

另请参阅

options testOption()

setOptions(options)#

参数:: 选项 – FontDialogOption 的组合

另请参阅

options()

属性optionsᅟ的设置器。

testOption(option)#

参数:: option – FontDialogOption
返回类型:: 布尔值

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

另请参阅

options setOption()