Dialog. Show Async Method
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Begins an asynchronous operation showing a dialog.
public: virtual IAsyncOperation<IUICommand ^> ^ ShowAsync() = ShowAsync;
public IAsyncOperation<IUICommand> ShowAsync();
Public Function ShowAsync () As IAsyncOperation(Of IUICommand)
An object that represents the asynchronous operation. For more on the async pattern, see Asynchronous programming.
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 ).