MessageDialog QML Type

Ein Nachrichten-Dialog. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

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

Ausführliche Beschreibung

Der MessageDialog-Typ bietet eine QML-API für Nachrichtendialoge.

Ein Meldungsdialog wird verwendet, um den Benutzer zu informieren oder ihm eine Frage zu stellen. Ein Meldungsdialog zeigt ein primäres text an, um den Benutzer auf eine Situation aufmerksam zu machen, ein informative text, um die Warnung näher zu erläutern oder dem Benutzer eine Frage zu stellen, und ein optionales detailed text, um noch mehr Daten zu liefern, wenn der Benutzer dies wünscht. Ein Meldungsfenster kann auch einen konfigurierbaren Satz von buttons anzeigen, um eine Benutzerantwort zu akzeptieren.

Um einen Nachrichtendialog anzuzeigen, konstruieren Sie eine Instanz von MessageDialog, stellen die gewünschten Eigenschaften ein und rufen open() auf.

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

Der Benutzer muss auf die Schaltfläche OK klicken, um den Nachrichtendialog zu schließen.

Ein aufwändigerer Ansatz, als den Benutzer nur auf ein Ereignis aufmerksam zu machen, besteht darin, den Benutzer auch zu fragen, was er tun soll. Speichern Sie die Frage in der Eigenschaft informative text, und geben Sie die Eigenschaft buttons für den Satz von Schaltflächen an, die Sie als Benutzerreaktionen verwenden möchten. Die Schaltflächen werden durch die Kombination von Werten mit dem bitweisen OR-Operator angegeben.

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

    onAccepted: document.save()
}

Verfügbarkeit

Ein plattformeigener Nachrichtendialog ist derzeit auf den folgenden Plattformen verfügbar:

• Android
• iOS
• macOS

Qt Quick Dialogs verwendet eine Qt Quick -Implementierung als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist.

Eigenschaft Dokumentation

Signal Dokumentation

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;
        }
    }
}