內容

• 特性
• 信號
• 詳細描述

MessageDialog QML Type

A native message dialog. 更多...

import 語句：	import Qt.labs.platform 1.0
Since:	Qt 5.8
繼承：	Dialog

• 所有成員列錶，包括繼承成員

特性

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

信號

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

詳細描述

The MessageDialog type provides a QML API for native platform message dialogs.

A message dialog is used to inform the user, or ask the user a question. A message dialog displays a primary text 以嚮用戶發齣狀況警報， 情報文本 以進一步闡述警報 (或嚮用戶詢問問題)，和可選 細節文本 to provide even more data if the user requests it. A message box can also display a configurable set of buttons 為接受用戶響應。

To show a message dialog, construct an instance of MessageDialog , set the desired properties, and call open() .

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

用戶必須點擊 OK button to dismiss the message dialog. A modal message dialog blocks the rest of the GUI until the message is dismissed.

A more elaborate approach than just alerting the user to an event is to also ask the user what to do about it. Store the question in the 情報文本 property, and specify the buttons property to the set of buttons you want as the set of user responses. The buttons are specified by combining values using the bitwise OR operator. The display order for the buttons is platform dependent.

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

The clicked() signal passes the information of which button was clicked.

A native platform message dialog is currently available on the following platforms:

• iOS
• Android
• WinRT

The Qt Labs Platform module uses Qt Widgets as a fallback on platforms that do not have a native implementation available. Therefore, applications that use types from the Qt Labs Platform module should link to QtWidgets and use QApplication 而不是 QGuiApplication .

要鏈接到 QtWidgets library, add the following to your qmake project file:

QT += widgets
					

Create an instance of QApplication in main() :

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

注意： Types in Qt.labs modules are not guaranteed to remain compatible in future versions.

特性文檔編製

buttons : flags

This property holds a combination of buttons that are used by the message dialog. The default value is MessageDialog.NoButton .

Possible flags:

常量	描述
MessageDialog.Ok	An "OK" button defined with the AcceptRole .
MessageDialog.Open	An "Open" button defined with the AcceptRole .
MessageDialog.Save	A "Save" button defined with the AcceptRole .
MessageDialog.Cancel	A "Cancel" button defined with the RejectRole .
MessageDialog.Close	A "Close" button defined with the RejectRole .
MessageDialog.Discard	A "Discard" or "Don't Save" button, depending on the platform, defined with the DestructiveRole .
MessageDialog.Apply	An "Apply" button defined with the ApplyRole .
MessageDialog.Reset	A "Reset" button defined with the ResetRole .
MessageDialog.RestoreDefaults	A "Restore Defaults" button defined with the ResetRole .
MessageDialog.Help	A "Help" button defined with the HelpRole .
MessageDialog.SaveAll	A "Save All" button defined with the AcceptRole .
MessageDialog.Yes	A "Yes" button defined with the YesRole .
MessageDialog.YesToAll	A "Yes to All" button defined with the YesRole .
MessageDialog.No	A "No" button defined with the NoRole .
MessageDialog.NoToAll	A "No to All" button defined with the NoRole .
MessageDialog.Abort	An "Abort" button defined with the RejectRole .
MessageDialog.Retry	A "Retry" button defined with the AcceptRole .
MessageDialog.Ignore	An "Ignore" button defined with the AcceptRole .
MessageDialog.NoButton	The dialog has no buttons.

另請參閱 clicked() .

detailedText : string

This property holds the text to be displayed in the details area.

另請參閱 text and informativeText .

informativeText : string

This property holds the informative text that provides a fuller description for the message.

Informative text can be used to expand upon the text to give more information to the user.

另請參閱 text and detailedText .

text : string

This property holds the text to be displayed on the message dialog.

另請參閱 informativeText and detailedText .

信號文檔編製

void abortClicked ()

此信號發射，當 Abort 被點擊。

void applyClicked ()

此信號發射，當 Apply 被點擊。

void cancelClicked ()

此信號發射，當 Cancel 被點擊。

void clicked ( button )

This signal is emitted when a dialog button 被點擊。

另請參閱 buttons .

void closeClicked ()

此信號發射，當 Close 被點擊。

void discardClicked ()

此信號發射，當 Discard 被點擊。

void helpClicked ()

此信號發射，當 幫助 被點擊。

void ignoreClicked ()

此信號發射，當 Ignore 被點擊。

void noClicked ()

此信號發射，當 No 被點擊。

void noToAllClicked ()

此信號發射，當 No To All 被點擊。

void okClicked ()

此信號發射，當 Ok 被點擊。

void openClicked ()

此信號發射，當 打開 被點擊。

void resetClicked ()

此信號發射，當 Reset 被點擊。

void restoreDefaultsClicked ()

此信號發射，當 Restore Defaults 被點擊。

void retryClicked ()

此信號發射，當 Retry 被點擊。

void saveAllClicked ()

此信號發射，當 Save All 被點擊。

void saveClicked ()

此信號發射，當 Save 被點擊。

void yesClicked ()

此信號發射，當 Yes 被點擊。

void yesToAllClicked ()

此信號發射，當 Yes To All 被點擊。