MessageDialog-Klasse

MessageDialog Class

Stellt ein Dialogfeld dar. Das Dialogfeld hat eine Befehlsleiste, die bis zu drei Befehle unterstützen kann. Wenn Sie keine Befehle angeben, wird das Dialogfeld mit einem Standardbefehl geschlossen.

Das Dialogfeld reduziert die Hintergrundhelligkeit des Bildschirms und verhindert die Übertragung von Berührungsvorgängen zur Benutzeroberfläche der App, bis der Nutzer reagiert.

Meldungsdialogfelder sollten sparsam benutzt werden und nur für Meldungen über schwerwiegende Fehler oder für einfache Fragen, die den Arbeitsfluss des Benutzers blockieren müssen.

Syntax


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

Attribute

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

Member

MessageDialogKlasse hat diese Membertypen:

Konstruktoren

MessageDialogKlasse hat diese Konstruktoren.

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

 

Methoden

The MessageDialog Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
ShowAsync Begins an asynchronous operation showing a dialog.

 

Eigenschaften

Der MessageDialogKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

CancelCommandIndex

Lese-/SchreibzugriffGets 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

SchreibgeschütztGets an array of commands that appear in the command bar of the message dialog. These commands makes the dialog actionable.

Content

Lese-/SchreibzugriffGets or sets the message to be displayed to the user.

DefaultCommandIndex

Lese-/SchreibzugriffGets 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

Lese-/SchreibzugriffGets or sets the options for a MessageDialog.

Title

Lese-/SchreibzugriffGets or sets the title to display on the dialog, if any.

 

Hinweise

Hinweis  : Es handelt sich nicht um eine agile Klasse. Daher müssen Sie das Threadingmodell und das Marshallingverhalten berücksichtigen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX) und Die Verwendung von Windows-Runtime-Objekten in einer Multithreaded-Umgebung (.NET).

Ein Beispiel eines Dialogfelds, wie im folgenden Beispiel erstellt:

Meldungsdialogfeld mit zwei Befehlen

Beispiele

Das folgende Beispiel zeigt, wie Meldungen einem Meldungsdialog hinzugefügt und angezeigt werden. Das vollständige Codebeispiel finden Sie im Meldungsdialogfeldbeispiel.


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

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

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

Metadaten

Windows.winmd

Siehe auch

Beispiel für Meldungsdialogfeld

 

 

Anzeigen:
© 2016 Microsoft