WebUINavigatedOperation
WebUINavigatedOperation
WebUINavigatedOperation
WebUINavigatedOperation
Class
Definition
Manages an app navigation operation.
public : sealed class WebUINavigatedOperation : IWebUINavigatedOperationpublic sealed class WebUINavigatedOperation : IWebUINavigatedOperationPublic NotInheritable Class WebUINavigatedOperation Implements IWebUINavigatedOperation// You can use this class in JavaScript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Remarks
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)
.
Methods
GetDeferral() GetDeferral() GetDeferral() GetDeferral()
Requests that the completion of app navigation be delayed.
public : WebUINavigatedDeferral GetDeferral()public WebUINavigatedDeferral GetDeferral()Public Function GetDeferral() As WebUINavigatedDeferral// You can use this method in JavaScript.
The navigated deferral object.
Remarks
When an app navigates or reloads its top level document, the system freezes the app’s visuals until the app indicates that it is ready to display its UI. The system transitions back to the app’s live UI when the app returns from its navigated event handler. However, some apps need to start asynchronous operations to retrieve state information and set up their UI (like using fragment loading to display app pages). Apps that must complete navigation asynchronously can get a deferral object from the navigated event arguments. This object enables the app to complete navigation outside its handler. When the app acquires the deferral object, its navigation is not completed when the navigation handler returns.
An app can complete navigation after its required asynchronous operations complete and it is ready to display its UI. App navigation is delayed until the app calls the WebUINavigatedDeferral.complete method.
Note that before an app completes navigation the app will appear hung to the user. It is important for the app to complete navigation as quickly as possible.
- See Also