WebUIApplication.Navigated Ereignis

Definition

Namespace:

Windows.UI.WebUI

Tritt auf, wenn die App navigiert.

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 

Ereignistyp

NavigatedEventHandler

Beispiele

Registrieren Sie sich für das navigierte Ereignis, und verwenden Sie das WebUINavigatedDeferral-Objekt, um das Aufheben der Benutzeroberfläche Ihrer App zu verzögern, bis der Zustand asynchron aus einer Datei geladen wird.

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);

Hinweise

In den meisten Fällen sollte eine HTML-basierte UWP-App niemals ihr Dokument der obersten Ebene navigieren oder neu laden müssen. Um den globalen Zustand aufrechtzuerhalten und ein reibungsloses Benutzererlebnis zu schaffen, ist es besser, dass Apps ihren HTML-Code dynamisch laden und entfernen, wenn sie dies auf derselben Seite der obersten Ebene benötigen.

In einigen seltenen Fällen muss Ihre App jedoch möglicherweise das Dokument der obersten Ebene navigieren oder neu laden. In diesem Fall wird das navigierte Ereignis ausgelöst, nachdem das Dokument der obersten Ebene navigiert oder neu geladen wurde. Es wird nach dem DOMContentLoaded-Ereignis und vor dem onLoad-Ereignis ausgelöst. Dieses Ereignis informiert die neue Seite darüber, dass sie aufgrund einer in der App-Navigation geladen wird, nicht aufgrund einer neuen Aktivierung. Sie können dieses Ereignis verwenden, um einen beliebigen gespeicherten Zustand für die Seite wiederherzustellen und die Benutzeroberfläche Ihrer App neu zu initialisieren.

Hinweis

Bevor dieses Ereignis ausgelöst wird, werden die Visuals Ihrer App eingefroren, sodass der Benutzer weiterhin die vorherige Seite Ihrer App sehen kann. Nachdem die Navigation abgeschlossen ist, wechselt das System zur Benutzeroberfläche Ihrer neuen Seite. Dadurch kann Ihre App ihre Benutzeroberfläche auf der neuen Seite einrichten, bevor der Benutzer sie sehen kann. Wenn Sie asynchrone Methoden verwenden müssen, um Ihre Benutzeroberfläche zu initialisieren, können Sie die navigatedOperation für die eventArgs verwenden, um den Abschluss der Navigation zu verzögern.