Represents a dialog. The dialog has a command bar that can support up to three commands. If you don't specify any commands, then a default command is added to close the dialog.
The dialog dims the screen behind it and blocks touch events from passing to the app's canvas until the user responds.
Message dialogs should be used sparingly, and only for critical messages or simple questions that must block the user's flow.
The MessageDialog class has these types of members:
The MessageDialog class has these constructors.
|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 class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.
|ShowAsync||Begins an asynchronous operation showing a dialog.|
The MessageDialog class has these properties.
|Read/write||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.|
|Read-only||Gets an array of commands that appear in the command bar of the message dialog. These commands makes the dialog actionable.|
|Read/write||Gets or sets the message to be displayed to the user.|
|Read/write||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.|
|Read/write||Gets or sets the options for a MessageDialog.|
|Read/write||Gets or sets the title to display on the dialog, if any.|
Note : This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).
An example of a dialog, as created by the following example:
The following example shows how to add commands to a message dialog and display it. For the full code example, see Message dialog sample.
Imports Windows.UI.Popups Imports Windows.UI.Xaml Imports Windows.UI.Xaml.Controls Imports Windows.UI.Xaml.Navigation Imports SDKTemplate Partial Public NotInheritable Class CloseCommand Inherits SDKTemplate.Common.LayoutAwarePage ' A pointer back to the main page. This is needed if you want to call methods in MainPage such ' as NotifyUser() Private rootPage As MainPage = MainPage.Current Public Sub New() Me.InitializeComponent() End Sub Private Async Sub CloseCommandLaunch_Click(sender As Object, e As RoutedEventArgs) ' Create the message dialog and set its content and title Dim messageDialog = New MessageDialog("No internet connection has been found.") ' Add buttons and set their callbacks messageDialog.Commands.Add(New UICommand("Try again", Sub(command) rootPage.NotifyUser("The '" & command.Label & "' button has been selected.", _ NotifyType.StatusMessage) End Sub)) messageDialog.Commands.Add(New UICommand("Close", Sub(command) rootPage.NotifyUser("The '" & command.Label & "' button has been selected.", _ NotifyType.StatusMessage) End Sub)) ' Set the command that will be invoked by default messageDialog.DefaultCommandIndex = 0 ' Set the command to be invoked when escape is pressed messageDialog.CancelCommandIndex = 1 ' Show the message dialog Await messageDialog.ShowAsync End Sub End Class
Minimum supported client
|Windows 8 [Windows Store apps only]|
Minimum supported server
|Windows Server 2012 [Windows Store apps only]|
Minimum supported phone
|Windows Phone 8.1 [Windows Runtime apps only]|