FontDialog QML 类型

一个原生的字体对话框。更多信息...

导入语句	导入 Qt.labs.platform
继承	Dialog

所有成员列表，包括继承成员

属性

currentFont : font
font : font
options : flags

详细描述

FontDialog 类型提供原生平台字体对话框的 QML API。

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

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

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

MyDocument {
    id: document
    font: fontDialog.font
}

可用性

当前以下平台上可用原生平台字体对话框

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

Qt Labs 平台模块在平台上使用 Qt Widgets 作为后备。因此，使用 Qt Labs 平台模块的类型的应用程序应链接到 QtWidgets 并使用 QApplication 而不是 QGuiApplication。

要链接到 QtWidgets 库，请在您的 qmake 项目文件中添加以下内容

QT += widgets

在 main() 中创建 QApplication 实例

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

注意：Qt.labs 模块中的类型在未来的版本中可能不保证兼容。

属性说明

currentFont : font

此属性保留对话框中当前选中的字体。

与 font 属性不同，在用户在对话框中选择字体时，currentFont 属性将被更新，甚至在最终选择完成之前。

另请参阅：font。

font : font

此属性保留最终接受的字体。

与 currentFont 属性不同，在用户在对话框中选择字体时，font 属性不会更新，但只有当用户点击 OK 以接受字体时才会更新。或者，可以处理 accepted() 信号以获取最终选择。

另请参阅 currentFont 和 accepted。

options : flags

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

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

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

可用选项

常量	描述
`FontDialog.ScalableFonts`	显示可缩放字体。
`FontDialog.NonScalableFonts`	显示不可缩放字体。
`FontDialog.MonospacedFonts`	显示等宽字体。
`FontDialog.ProportionalFonts`	显示比例字体。
`FontDialog.NoButtons`	不显示确定和取消按钮（对“实时对话框”很有用）。