MessageDialog Class

대화 상자를 나타냅니다. 이 대화 상자에는 최대 3개의 명령을 지원할 수 있는 명령줄이 있습니다. 명령을 지정하지 않을 경우 대화 상자를 닫는 기본 명령이 추가됩니다.

대화 상자에서 화면을 흐리게 표시하고 사용자가 응답할 때까지 터치 이벤트가 응용 프로그램의 캔버스로 전달되는 것을 차단합니다.

메시지 대화 상자는 될 수 있으면 사용하지 말고 사용자의 흐름을 차단해야 하는 간단한 질문이나 중요한 메시지에만 사용해야 합니다.

구문


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

특성

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

멤버

MessageDialog클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

MessageDialog클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
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.

 

메서드

The MessageDialog 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
ShowAsync Begins an asynchronous operation showing a dialog.

 

속성

MessageDialog클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

CancelCommandIndex

읽기/쓰기Gets 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

읽기 전용Gets an array of commands that appear in the command bar of the message dialog. These commands makes the dialog actionable.

Content

읽기/쓰기Gets or sets the message to be displayed to the user.

DefaultCommandIndex

읽기/쓰기Gets 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

읽기/쓰기Gets or sets the options for a MessageDialog.

Title

읽기/쓰기Gets or sets the title to display on the dialog, if any.

 

설명

참고  : 이 클래스는 Agile 클래스가 아닙니다. 즉, 이 클래스의 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하십시오.

다음 예제를 통해 만든 대화 상자의 예:

두 개의 명령이 포함된 메시지 대화 상자

예제

다음 예제에서는 메시지 대화 상자에 명령을 추가하고 표시하는 방법을 보여 줍니다. 전체 코드 예제는 메시지 대화 상자 샘플을 참조하십시오.


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

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

Namespace

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

Metadata

Windows.winmd

참고 항목

메시지 대화 상자 샘플

 

 

표시:
© 2014 Microsoft