MessageDialog QML 类型

消息对话框。 更多...

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

属性

• buttons : flags
• detailedText : string
• informativeText : string
• text : string

信号

• buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)

详细描述

MessageDialog 类型提供了消息对话框的 QML API。

消息对话框用于通知用户或向用户提出问题。消息对话框显示主要 文本 以提醒用户注意情况，信息文本 以进一步解释警报或询问用户问题，以及在用户请求时提供更多数据的可选 详细文本。消息框还可以显示一个可配置的按钮集，以接受用户的响应。

要显示消息对话框，构建一个 MessageDialog 实例，设置所需的属性，并调用 open()。

MessageDialog {
    buttons: MessageDialog.Ok
    text: "The document has been modified."
}

用户必须单击 OK 按钮，才能关闭消息对话框。

比仅仅提醒用户一个事件更为详细的方法是还询问用户如何处理它。在 信息文本 属性中存储问题，并将 按钮 属性指定为您想要作为用户响应集的按钮。按钮由使用按位或操作符合并的值指定。

MessageDialog {
    text: "The document has been modified."
    informativeText: "Do you want to save your changes?"
    buttons: MessageDialog.Ok | MessageDialog.Cancel

    onAccepted: document.save()
}

可用性

以下平台目前提供原生平台消息对话框：

• Android
• iOS
• macOS

Qt Quick 对话框在缺少原生实现的可用的平台上使用 Qt Quick 实现作为后备。

属性文档

信号文档

MessageDialog {
    id: dialog
    text: qsTr("The document has been modified.")
    informativeText: qsTr("Do you want to save your changes?")
    buttons: MessageDialog.Ok | MessageDialog.Cancel
    onButtonClicked: function (button, role) {
        switch (button) {
        case MessageDialog.Ok:
            document.save()
            break;
        }
    }
}