字体对话框 QML 类型

一个字体对话框。更多...

导入语句	import QtQuick.Dialogs
自从	Qt 6.2
继承	对话框

属性

options : flags
selectedFont : font

详细描述

FontDialog 类型提供了一个 QML API 用于字体对话框。

要显示字体对话框，构建一个 FontDialog 实例，设置所需的属性，并调用 open()。可以使用 currentFont 属性来确定对话框中当前选择的字体。只有在最终选择后被接受后，selectedFont 属性才会更新。

MenuItem {
    text: "Font"
    onTriggered: fontDialog.open()
}

FontDialog {
    id: fontDialog
    currentFont.family: document.font
}

MyDocument {
    id: document
    font: fontDialog.selectedFont
}

可用性

以下平台上目前可用本机平台字体对话框

iOS
Linux（当使用 GTK+ 平台主题运行时）
macOS

对于尚未提供本机实现的平台，Qt Quick Dialogs 使用 Qt Quick 实现将作为后备方案。

属性文档

options : flags

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

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

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

可用选项

常数	描述
`FontDialog.ScalableFonts`	显示可缩放字体。
`FontDialog.NonScalableFonts`	显示不可缩放字体。
`FontDialog.MonospacedFonts`	显示等宽字体。
`FontDialog.ProportionalFonts`	显示比例字体。
`FontDialog.NoButtons`	不显示打开和取消按钮（适用于“弹出对话框”）。
`FontDialog.DontUseNativeDialog`	强制对话框使用非本机快速实现。

selectedFont : font

此属性包含对话框中当前选择的字体。

在用户在对话框中选择字体时，selectedFont 属性会更新，甚至在最终选择做出之前。

可以处理accepted() 信号以获取最终选择。当用户点击打开以接受字体时，对于 accepted() 信号的信号处理器可以查询 accepted() 信号处理器[selectedFont] 属性以获得用户最终选择的字体。

另请参阅currentFont 和 accepted。