MessageDialog.ShowAsync Method

Definition

Namespace:

Windows.UI.Popups

Begins an asynchronous operation showing a dialog.

public:
 virtual IAsyncOperation<IUICommand ^> ^ ShowAsync() = ShowAsync;

IAsyncOperation<IUICommand> ShowAsync();

public IAsyncOperation<IUICommand> ShowAsync();

function showAsync()

Public Function ShowAsync () As IAsyncOperation(Of IUICommand)

Returns

IAsyncOperation<IUICommand>

An object that represents the asynchronous operation. For more on the async pattern, see Asynchronous programming.

Remarks

In some cases, the system may close the dialog, like when people invoke an app contract when the dialog is showing. IAsyncOperation(IUICommand).GetResults returns either the command selected which destroyed the dialog, or an empty command.

To launch subsequent dialogs or other modal UI such as file pickers after a dialog has been closed, use the then or done functions of the Promise object. You cannot launch modal UI from within a UICommand callback.

Calling showAsync while the splash screen is being displayed

• In : Your app can call showAsync from within the activated handler (the onactivated event or the CoreApplicationView.Activated event), and paint operations then occur behind the app's splash screen.
• Beginning in : Windows suppresses painting while the app is behind the splash screen to reduce wasteful operations. Your app should not call showAsync from within the activated handler, but should instead wait for the visibility changed notification (the visibilitychange event or the CoreWindow.VisibilityChanged event).