WebUIApplication.Navigated イベント

定義

名前空間:

Windows.UI.WebUI

アプリが移動しているときに発生します。

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 

イベントの種類

NavigatedEventHandler

例

移動したイベントに登録し、WebUINavigatedDeferral オブジェクトを使用して、状態がファイルから非同期的に読み込まれるまでアプリの UI の凍結解除を遅延させます。

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

注釈

ほとんどの場合、HTML ベースの UWP アプリは、最上位のドキュメントを移動または再読み込みする必要はありません。 グローバルな状態を維持し、スムーズなユーザー エクスペリエンスを作成するには、アプリが同じ最上位ページ内で必要に応じて HTML を動的に読み込んで破棄することをお勧めします。

ただし、まれに、アプリの最上位ドキュメントを移動または再読み込みする必要がある場合があります。 その場合、最上位レベルのドキュメントが移動または再読み込みされた後に、移動されたイベントが発生します。 DOMContentLoaded イベントの後と onLoad イベントの前に発生します。 このイベントは、新しいアクティブ化ではなく、アプリ ナビゲーションの が原因で読み込まれていることを新しいページに通知します。 このイベントを使用して、ページの保存された状態を復元し、アプリの UI を再初期化できます。

Note

このイベントが発生する前に、ユーザーがアプリの前のページを引き続き表示できるように、アプリのビジュアルが固定されます。 移動が完了すると、システムは新しいページの UI に切り替わります。 これにより、ユーザーに表示される前に、アプリで新しいページに UI を設定できます。 非同期メソッドを使用して UI を初期化する必要がある場合は、eventArgs の navigatedOperation を使用して、ナビゲーションの完了を延期できます。