MessageDialog QML Type

Une boîte de dialogue de messages. Plus d'informations...

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

Propriétés

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

Signaux

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

Description détaillée

Le type MessageDialog fournit une API QML pour les boîtes de dialogue.

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 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 pour 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.

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

    onAccepted: document.save()
}

Disponibilité

Une boîte de dialogue native est actuellement disponible sur les plates-formes suivantes :

• Android
• iOS
• macOS

Qt Quick Dialogs utilise une implémentation Qt Quick comme solution de repli sur les plateformes qui n'ont pas d'implémentation native disponible.

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 buttonClicked().

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

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

Ce signal est émis lorsqu'un button avec le role spécifié est cliqué.

En donnant à ce signal un gestionnaire, vous pouvez répondre à n'importe quel bouton personnalisé pressé. L'argument button indique quel bouton a été cliqué, tandis que l'argument role indique le rôle fonctionnel de ce bouton.

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

Voir également buttons.