MessageDialog QML Type

本地消息对话框。更多

自 Qt.labs.platform 6.9 起，该类型已被弃用。我们强烈建议不要在新代码中使用它。

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

属性

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

信号

• abortClicked()
• applyClicked()
• cancelClicked()
• clicked(button)
• closeClicked()
• discardClicked()
• helpClicked()
• ignoreClicked()
• noClicked()
• noToAllClicked()
• okClicked()
• openClicked()
• resetClicked()
• restoreDefaultsClicked()
• retryClicked()
• saveAllClicked()
• saveClicked()
• yesClicked()
• yesToAllClicked()

详细说明

使用QtQuick.Dialogs::MessageDialog 代替。

MessageDialog 类型为本地平台消息对话框提供了 QML API。

消息对话框用于通知用户或向用户提问。消息对话框会显示一个主要的text 来提醒用户注意某种情况，一个informative text 来进一步解释该提醒或向用户提问，以及一个可选的detailed text 来在用户要求时提供更多数据。消息框还可以显示一组可配置的buttons ，用于接受用户回复。

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

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

用户必须单击OK 按钮才能解除消息对话框。模态消息对话框会阻止图形用户界面的其他部分，直到消息被取消。

除了提醒用户注意事件外，一种更复杂的方法是询问用户如何处理该事件。将问题存储在informative text 属性中，并在buttons 属性中指定一组按钮作为用户响应。这些按钮是通过使用位顺时针 OR 运算符组合值来指定的。按钮的显示顺序取决于平台。

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

    onAccepted: document.save()
}

clicked() 信号会传递哪个按钮被点击的信息。

本机平台消息对话框目前在以下平台上可用：

• 安卓
• iOS
• macOS

在没有本地实现的平台上，Qt Labs Platform 模块使用Qt Widgets 作为后备。因此，使用Qt Labs Platform 模块中类型的应用程序应链接到 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();
}

另请参阅 QtQuick.Dialogs::MessageDialog 。

属性文档

信号文档