MessageDialog QML Type

Une boîte de dialogue de message native. Plus...

Ce type est obsolète depuis Qt.Labs.Platform 6.9. Il est fortement déconseillé de l'utiliser dans un nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Signaux

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

Description détaillée

Utilisez plutôt QtQuick.Dialogs MessageDialog.

Le type MessageDialog fournit une API QML pour les boîtes de dialogue de la plate-forme native.

Une boîte de dialogue est utilisée pour informer l'utilisateur ou lui poser une question. Une boîte de dialogue affiche un message principal text pour alerter l'utilisateur d'une situation, un message informative text pour expliquer davantage l'alerte ou pour poser une question à l'utilisateur, et un message facultatif detailed text pour fournir encore plus de données si l'utilisateur le demande. Une boîte de message peut également afficher un ensemble configurable de buttons pour accepter une réponse de l'utilisateur.

Pour afficher une boîte de dialogue, construisez une instance de MessageDialog, définissez les propriétés souhaitées et appelez open().

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

L'utilisateur doit cliquer sur le bouton OK pour fermer la boîte de dialogue. Une boîte de dialogue modale bloque le reste de l'interface graphique jusqu'à ce que le message soit supprimé.

Une approche plus élaborée que le simple fait d'alerter l'utilisateur d'un événement consiste à lui demander ce qu'il doit faire à ce sujet. Stockez la question dans la propriété informative text, et spécifiez la propriété buttons à l'ensemble des boutons que vous voulez comme ensemble de réponses de l'utilisateur. Les boutons sont spécifiés en combinant des valeurs à l'aide de l'opérateur bitwise OR. L'ordre d'affichage des boutons dépend de la plate-forme.

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

    onAccepted: document.save()
}

Le signal clicked() transmet l'information concernant le bouton sur lequel l'utilisateur a cliqué.

Une boîte de dialogue native est actuellement disponible sur les plateformes suivantes :

• Android
• iOS
• macOS

Le module Qt Labs Platform utilise Qt Widgets comme solution de repli sur les plateformes qui ne disposent pas d'une implémentation native. Par conséquent, les applications qui utilisent des types du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication au lieu de QGuiApplication.

Pour établir un lien avec la bibliothèque QtWidgets, ajoutez ce qui suit à votre fichier de projet qmake :

QT += widgets

Créez une instance de QApplication dans 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();
}

Voir aussi QtQuick.Dialogs::MessageDialog.

Documentation sur les propriétés

buttons : flags

Cette propriété contient une combinaison de boutons utilisés par la boîte de dialogue de messages. La valeur par défaut est MessageDialog.NoButton.

Drapeaux possibles :

Voir aussi clicked().

detailedText : string

Cette propriété contient le texte à afficher dans la zone de détails.

Voir également text et informativeText.

informativeText : string

Cette propriété contient le texte informatif qui fournit une description plus complète du message.

Le texte informatif peut être utilisé pour développer le site text et donner plus d'informations à l'utilisateur.

Voir également text et detailedText.

text : string

Cette propriété contient le texte à afficher dans la boîte de dialogue.

Voir également informativeText et detailedText.

Documentation sur les signaux

abortClicked()

Ce signal est émis lorsque Abort est cliqué.

applyClicked()

Ce signal est émis lorsque Apply est cliqué.

cancelClicked()

Ce signal est émis lorsque Cancel est cliqué.

clicked(button)

Ce signal est émis lorsqu'un dialogue button est cliqué.

Voir aussi buttons.

closeClicked()

Ce signal est émis lorsque Close est cliqué.

discardClicked()

Ce signal est émis lorsque Discard est cliqué.

helpClicked()

Ce signal est émis lorsque Help est cliqué.

ignoreClicked()

Ce signal est émis lorsque Ignore est cliqué.

noClicked()

Ce signal est émis lorsque No est cliqué.

noToAllClicked()

Ce signal est émis lorsque No To All est cliqué.

okClicked()

Ce signal est émis lorsque Ok est cliqué.

openClicked()

Ce signal est émis lorsque Open est cliqué.

resetClicked()

Ce signal est émis lorsque Reset est cliqué.

restoreDefaultsClicked()

Ce signal est émis lorsque Restore Defaults est cliqué.

retryClicked()

Ce signal est émis lorsque Retry est cliqué.

saveAllClicked()

Ce signal est émis lorsque Save All est cliqué.

saveClicked()

Ce signal est émis lorsque Save est cliqué.

yesClicked()

Ce signal est émis lorsque Yes est cliqué.

yesToAllClicked()

Ce signal est émis lorsque Yes To All est cliqué.