MessageDialog QML Type

Une boîte de dialogue de message native. En savoir plus…

Ce type est obsolète depuis Qt Labs Platform 6.9. Nous déconseillons fortement de l'utiliser dans du 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 message natives de la plateforme.

Une boîte de dialogue de message sert à informer l’utilisateur ou à lui poser une question. Une boîte de dialogue de message affiche une « text » principale pour alerter l’utilisateur d’une situation, une « informative text » pour expliquer plus en détail l’alerte ou poser une question à l’utilisateur, et une « detailed text » facultative pour fournir encore plus d’informations si l’utilisateur le demande. Une boîte de message peut également afficher un ensemble configurable de « buttons » pour accepter la réponse de l’utilisateur.

Pour afficher une boîte de dialogue de message, créez une instance de `MessageDialog`, définissez les propriétés souhaitées, puis appelez la méthode ` 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 fermé.

Une approche plus élaborée que le simple fait d’alerter l’utilisateur d’un événement consiste à lui demander également comment réagir. Stockez la question dans la propriété ` informative text `, puis définissez la propriété ` buttons ` sur l’ensemble des boutons que vous souhaitez proposer comme réponses à l’utilisateur. Les boutons sont spécifiés en combinant des valeurs à l’aide de l’opérateur OR binaire. 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 indiquant quel bouton a été cliqué.

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

• Android
• iOS
• macOS

Le module Qt Labs Platform utilise Qt Widgets comme solution de secours sur les plateformes ne disposant pas d’une implémentation native. Par conséquent, les applications utilisant des types du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication à la place de QGuiApplication.

Pour lier votre application à 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 également QtQuick.Dialogs::MessageDialog.

Documentation sur les propriétés

buttons : flags

Cette propriété contient un ensemble de boutons utilisés par la boîte de dialogue de message. La valeur par défaut est MessageDialog.NoButton.

Indicateurs possibles :

Voir également 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 explicatif qui fournit une description plus détaillée du message.

Le texte explicatif peut être utilisé pour compléter l'text s et fournir davantage d'informations à l'utilisateur.

Voir également « text » et « detailedText ».

text : string

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

Voir également informativeText et detailedText.

Documentation sur les signaux

abortClicked()

Ce signal est émis lorsqu'on clique sur Abort.

applyClicked()

Ce signal est émis lorsqu'on clique sur Apply.

cancelClicked()

Ce signal est émis lorsqu'on clique sur Cancel.

clicked(button)

Ce signal est émis lorsqu'on clique sur une boîte de dialogue button.

Voir également buttons.

closeClicked()

Ce signal est émis lorsqu'on clique sur Close.

discardClicked()

Ce signal est émis lorsqu'on clique sur Discard.

helpClicked()

Ce signal est émis lorsqu'on clique sur Help.

ignoreClicked()

Ce signal est émis lorsqu'on clique sur Ignore.

noClicked()

Ce signal est émis lorsqu'on clique sur No.

noToAllClicked()

Ce signal est émis lorsqu'on clique sur No To All.

okClicked()

Ce signal est émis lorsqu'on clique sur Ok.

openClicked()

Ce signal est émis lorsque l'on clique sur Open.

resetClicked()

Ce signal est émis lorsque l'on clique sur Reset.

restoreDefaultsClicked()

Ce signal est émis lorsqu'on clique sur Restore Defaults.

retryClicked()

Ce signal est émis lorsqu'on clique sur Retry.

saveAllClicked()

Ce signal est émis lorsqu'on clique sur Save All.

saveClicked()

Ce signal est émis lorsqu'on clique sur Save.

yesClicked()

Ce signal est émis lorsqu'on clique sur Yes.

yesToAllClicked()

Ce signal est émis lorsqu'on clique sur Yes To All.