WebUIApplication.Navigated Événement

Définition

Espace de noms:

Windows.UI.WebUI

Se produit lorsque l’application navigue.

public:
 static event NavigatedEventHandler ^ Navigated;

// Register
static event_token Navigated(NavigatedEventHandler const& handler) const;

// Revoke with event_token
static void Navigated(event_token const* cookie) const;

// Revoke with event_revoker
static WebUIApplication::Navigated_revoker Navigated(auto_revoke_t, NavigatedEventHandler const& handler) const;

public static event NavigatedEventHandler Navigated;

function onNavigated(eventArgs) { /* Your code */ }
Windows.UI.WebUI.WebUIApplication.addEventListener("navigated", onNavigated);
Windows.UI.WebUI.WebUIApplication.removeEventListener("navigated", onNavigated);
- or -
Windows.UI.WebUI.WebUIApplication.onnavigated = onNavigated;

Public Shared Custom Event Navigated As NavigatedEventHandler 

Type d'événement

NavigatedEventHandler

Exemples

Inscrivez-vous à l’événement parcouru et utilisez l’objet WebUINavigatedDeferral pour retarder le dégel de l’interface utilisateur de votre application jusqu’à ce que l’état soit chargé de manière asynchrone à partir d’un fichier.

function navigatedHandler(eventArgs) {

    var deferral = eventArgs.navigatedOperation.getDeferral();

    // Populate the text box with the previously saved value while the app visuals are frozen
    app.local.readText(myfile, "default").then(function (str) {
        document.getElementById("userText").value = str;

        // Complete the deferral to transition back to a live view of the app
        deferral.complete();
    }, function(error) {
        document.getElementById("userText").value = 'undefined';

        // Complete the deferral even in the case where readText fails 
        // else the app would appear hung to the user
        deferral.complete();
    });
}

Windows.UI.WebUI.WebUIApplication.addEventListener("navigated", navigatedHandler, false);

Remarques

Dans la plupart des cas, une application UWP basée sur HTML ne doit jamais avoir à naviguer ou à recharger son document de niveau supérieur. Pour maintenir un état global et créer une expérience utilisateur fluide, il est préférable que les applications chargent et démontent dynamiquement leur CODE HTML comme ils le doivent dans la même page de niveau supérieur.

Toutefois, dans de rares cas, votre application peut avoir besoin de naviguer ou de recharger son document de niveau supérieur. Dans ce cas, l’événement parcouru est déclenché une fois que le document de niveau supérieur a été parcouru ou rechargé. Il est déclenché après l’événement DOMContentLoaded et avant l’événement onLoad . Cet événement informe la nouvelle page qu’elle est chargée en raison d’une navigation dans l’application, et non d’une nouvelle activation. Vous pouvez utiliser cet événement pour restaurer n’importe quel état enregistré pour la page et réinitialiser l’interface utilisateur de votre application.

Notes

Avant que cet événement ne soit déclenché, les visuels de votre application seront gelés afin que l’utilisateur continue à voir la page précédente de votre application. Une fois la navigation terminée, les transitions système vers l’interface utilisateur de votre nouvelle page. Cela permet à votre application de configurer son interface utilisateur sur la nouvelle page avant que l’utilisateur ne puisse la voir. Si vous devez utiliser des méthodes asynchrones pour initialiser votre interface utilisateur, vous pouvez utiliser navigatedOperation sur eventArgs pour différer l’achèvement de la navigation.