MessageDialog QML Type

Ein nativer Meldungsdialog. Mehr...

Dieser Typ ist seit Qt Labs Platform 6.9 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

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

Ausführliche Beschreibung

Verwenden Sie stattdessen „ QtQuick.Dialogs MessageDialog “.

Der Typ „MessageDialog“ stellt eine QML-API für native Plattform-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 Meldung 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 Meldungsfeld kann zudem eine konfigurierbare Reihe von „ buttons “ anzeigen, um eine Antwort des Benutzers entgegenzunehmen.

Um einen Meldungsdialog 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 das Meldungsdialogfeld zu schließen. Ein modales Meldungsdialogfeld blockiert den Rest der Benutzeroberfläche, bis die Meldung geschlossen wird.

Ein ausgefeilterer Ansatz als die bloße Benachrichtigung des Benutzers über ein Ereignis besteht darin, den Benutzer auch zu fragen, wie er darauf reagieren 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 OR-Operators festgelegt. Die Anzeigereihenfolge der Schaltflächen ist plattformabhängig.

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

    onAccepted: document.save()
}

Das Signal „ clicked()“ übermittelt die Information, welche Schaltfläche angeklickt wurde.

Ein nativer Plattform-Meldungsdialog ist derzeit auf den folgenden Plattformen verfügbar:

• Android
• iOS
• macOS

Das Modul „ Qt Labs Platform “ verwendet „ Qt Widgets “ als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Modul „ Qt Labs Platform “ verwenden, eine Verknüpfung zu „ QtWidgets “ herstellen und „ QApplication “ anstelle von „ QGuiApplication “ verwenden.

Um eine Verknüpfung mit der Bibliothek „ QtWidgets “ herzustellen, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:

QT += widgets

Erstellen Sie eine Instanz von „ QApplication “ in „ main() “:

#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();
}

Siehe auch „ QtQuick.Dialogs::MessageDialog “.

Dokumentation zu den 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 ` clicked()`().

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 informierende Text kann verwendet werden, um die „ text “ zu ergänzen und dem Benutzer weitere Informationen zu geben.

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

abortClicked()

Dieses Signal wird ausgelöst, wenn auf Abort geklickt wird.

applyClicked()

Dieses Signal wird ausgelöst, wenn auf „ Apply “ geklickt wird.

cancelClicked()

Dieses Signal wird ausgelöst, wenn auf „ Cancel “ geklickt wird.

clicked(button)

Dieses Signal wird ausgelöst, wenn auf ein Dialog button -Element geklickt wird.

Siehe auch „ buttons “.

closeClicked()

Dieses Signal wird ausgelöst, wenn auf „ Close “ geklickt wird.

discardClicked()

Dieses Signal wird ausgelöst, wenn auf „ Discard “ geklickt wird.

helpClicked()

Dieses Signal wird ausgelöst, wenn auf „ Help “ geklickt wird.

ignoreClicked()

Dieses Signal wird ausgelöst, wenn auf „ Ignore “ geklickt wird.

noClicked()

Dieses Signal wird ausgelöst, wenn auf „ No “ geklickt wird.

noToAllClicked()

Dieses Signal wird ausgelöst, wenn auf „ No To All “ geklickt wird.

okClicked()

Dieses Signal wird ausgelöst, wenn auf „ Ok “ geklickt wird.

openClicked()

Dieses Signal wird ausgelöst, wenn auf „ Open “ geklickt wird.

resetClicked()

Dieses Signal wird ausgelöst, wenn auf „ Reset “ geklickt wird.

restoreDefaultsClicked()

Dieses Signal wird ausgelöst, wenn auf „ Restore Defaults “ geklickt wird.

retryClicked()

Dieses Signal wird ausgelöst, wenn auf „ Retry “ geklickt wird.

saveAllClicked()

Dieses Signal wird ausgelöst, wenn auf „ Save All “ geklickt wird.

saveClicked()

Dieses Signal wird ausgelöst, wenn auf Save geklickt wird.

yesClicked()

Dieses Signal wird ausgelöst, wenn auf „ Yes “ geklickt wird.

yesToAllClicked()

Dieses Signal wird ausgelöst, wenn auf „ Yes To All “ geklickt wird.