MessageDialog, classe

MessageDialog Class

Représente une boîte de dialogue. La boîte de dialogue comporte une barre de commandes qui peut prendre en charge jusqu'à trois commandes. Si vous ne spécifiez aucune commande, une commande par défaut est ajoutée pour fermer la boîte de dialogue.

La boîte de dialogue estompe l'écran et empêche les événements tactiles de passer à la zone de dessin de l'application jusqu'à ce que l'utilisateur réponde.

Les boîtes de dialogue de message doivent être utilisés avec modération, et uniquement pour les messages critiques ou des questions simples qui doivent bloquer le flux de l'utilisateur.

Syntaxe


var messageDialog = new Windows.UI.Popups.MessageDialog(string);
var messageDialog = new Windows.UI.Popups.MessageDialog(string, string);

Attributs

[MarshalingBehavior(Standard)]
[Muse()]
[Version(0x06020000)]

Membres

MessageDialogClasse possède ces types de membres :

Constructeurs

MessageDialogClasse possède ces constructeurs.

ConstructeurDescription
MessageDialog(String) Initializes a new instance of the MessageDialog class to display an untitled message dialog that can be used to ask your user simple questions.
MessageDialog(String, String) Initializes a new instance of the MessageDialog class to display a titled message dialog that can be used to ask your user simple questions.

 

Méthodes

The MessageDialog Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
ShowAsync Begins an asynchronous operation showing a dialog.

 

Propriétés

Le MessageDialogClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CancelCommandIndex

Lecture/écritureGets or sets the index of the command you want to use as the cancel command. This is the command that fires when users press the ESC key.

Commands

En lecture seuleGets an array of commands that appear in the command bar of the message dialog. These commands makes the dialog actionable.

Content

Lecture/écritureGets or sets the message to be displayed to the user.

DefaultCommandIndex

Lecture/écritureGets or sets the index of the command you want to use as the default. This is the command that fires by default when users press the ENTER key.

Options

Lecture/écritureGets or sets the options for a MessageDialog.

Title

Lecture/écritureGets or sets the title to display on the dialog, if any.

 

Remarques

Remarque   : cette classe n'est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez les rubriques Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Un exemple de boîte de dialogue, tel que créé par l'exemple suivant :

Boîte de message avec deux commandes

Exemples

L'exemple suivant indique comment ajouter des commandes à une boîte de dialogue de message et les afficher. Pour l'exemple de code complet, consultez Exemple de boîte de dialogue de message.


(function () {
    "use strict";
    var page = WinJS.UI.Pages.define("/html/cancelcommand.html", {
        ready: function (element, options) {
            document.getElementById("cancelCommand").addEventListener(
                "click", 
                cancelCommand_Click, false);
        }
    });

    // Click handler for the 'cancelCommand' button.
    // Demonstrates setting the command to be invoked when the 'escape' key is pressed.
    // Also demonstrates retrieval of the label of the chosen command and setting a 
    // callback to a function.
    // A message will be displayed indicating which command was invoked.
    // In this scenario, 'Try again' is selected as the default choice, and the 
    // 'escape' key will invoke the command named 'Close'
    function cancelCommand_Click() {
        // Create the message dialog and set its content
        var msg = new Windows.UI.Popups.MessageDialog(
            "No internet connection has been found.");

        // Add commands and set their command handlers
        msg.commands.append(new Windows.UI.Popups.UICommand(
            "Try again", 
            commandInvokedHandler));
        msg.commands.append(
            new Windows.UI.Popups.UICommand("Close", commandInvokedHandler));

        // Set the command that will be invoked by default
        msg.defaultCommandIndex = 0;

        // Set the command to be invoked when escape is pressed
        msg.cancelCommandIndex = 1;

        // Show the message dialog
        msg.showAsync();
    }

    function commandInvokedHandler(command) {
        // Display message
        WinJS.log && WinJS.log("The '" + command.label + "' command has been selected.", 
        "sample", "status");
    }
})();

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Popups
Windows::UI::Popups [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple de boîte de dialogue de message

 

 

Afficher:
© 2018 Microsoft