MessageDialog QML Type

Ein Meldungsdialog. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

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

Signale

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

Ausführliche Beschreibung

Der Typ „MessageDialog“ stellt eine QML-API für Meldungsdialoge bereit.

Ein Meldungsdialog dient dazu, 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, sowie ein optionales „ detailed text “, um auf Wunsch des Benutzers weitere Daten bereitzustellen. Ein Meldungsdialog kann außerdem eine konfigurierbare Reihe von „ buttons “ anzeigen, um eine Antwort des Benutzers entgegenzunehmen.

Um ein Meldungsdialogfeld anzuzeigen, erstellen Sie eine Instanz von `MessageDialog`, legen Sie die gewünschten Eigenschaften fest und rufen Sie ` open()` auf.

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

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

Ein ausgefeilterer Ansatz als die bloße Benachrichtigung des Benutzers über ein Ereignis besteht darin, den Benutzer auch zu fragen, wie damit verfahren werden soll. Speichern Sie die Frage in der Eigenschaft „ informative text “ und legen Sie die Eigenschaft „ buttons “ auf die Gruppe von Schaltflächen fest, die Sie als Auswahlmöglichkeiten für die Benutzerantworten wünschen. Die Schaltflächen werden durch die Kombination von Werten mithilfe des bitweisen ODER-Operators festgelegt.

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 nativer Plattform-Meldungsdialog ist derzeit auf den folgenden Plattformen verfügbar:

• Android
• iOS
• macOS

Qt Quick Dialogs verwendet auf Plattformen, auf denen keine native Implementierung verfügbar ist, eine „ Qt Quick “-Implementierung als Fallback.

Dokumentation zu Eigenschaften

buttons : flags

Diese Eigenschaft enthält eine Kombination von Schaltflächen, die vom Meldungsdialogfeld verwendet werden. Der Standardwert lautet „ MessageDialog.NoButton “.

Mögliche Flags:

Siehe auch ` buttonClicked()`.

detailedText : string

Diese Eigenschaft enthält den Text, der im Detailbereich angezeigt werden soll.

Siehe auch text und informativeText.

informativeText : string

Diese Eigenschaft enthält den informativen Text, der eine ausführlichere Beschreibung der Meldung liefert.

Der informativen Text kann verwendet werden, um den „ text “ zu ergänzen und dem Benutzer weitere Informationen zu liefern.

Siehe auch „ text “ und „ detailedText “.

text : string

Diese Eigenschaft enthält den Text, der im Meldungsdialogfeld angezeigt werden soll.

Siehe auch informativeText und detailedText.

Signal-Dokumentation

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

Dieses Signal wird ausgelöst, wenn auf eine Schaltfläche „ button “ mit dem angegebenen „ role “ geklickt wird.

Indem Sie diesem Signal einen Handler zuweisen, können Sie auf das Drücken beliebiger benutzerdefinierter Schaltflächen reagieren. Das Argument ` button ` gibt an, welche Schaltfläche angeklickt wurde, während das Argument ` role ` die funktionale Rolle dieser Schaltfläche angibt.

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

Siehe auch „ buttons “.