MessageDialog QML Type

Ein nativer Nachrichtendialog. Mehr...

• 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()

Detaillierte Beschreibung

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

Ein Nachrichtendialog 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 bereitzustellen, 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 modaler Nachrichtendialog blockiert den Rest der GUI, bis die Nachricht beendet wird.

Ein aufwändigerer Ansatz als die bloße Benachrichtigung des Benutzers über ein Ereignis besteht darin, den Benutzer auch zu fragen, was er tun soll. Speichern Sie die Frage in der Eigenschaft informative text und geben Sie in der Eigenschaft buttons den Satz von Schaltflächen an, den Sie als Antwort des Benutzers wünschen. Die Schaltflächen werden durch die Kombination von Werten mit dem bitweisen OR-Operator festgelegt. Die Anzeigereihenfolge für die 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() übergibt die Information, welche Schaltfläche angeklickt wurde.

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

• Android
• iOS
• macOS

Das Qt Labs Platform Modul verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Qt Labs Platform Modul verwenden, mit QtWidgets verknüpft werden und QApplication anstelle von QGuiApplication verwenden.

Um gegen die QtWidgets-Bibliothek zu linken, fügen Sie das Folgende zu Ihrer qmake-Projektdatei hinzu:

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

Eigenschaft Dokumentation

Signal Dokumentation