2 ページ間でのピアツーピアのナビゲーション - Windows apps

[アーティクル]
07/04/2024

フレームとページを使用して、アプリで基本的なピアツーピアナビゲーションを有効にする方法について説明します。

ピアツーピアナビゲーション

ほぼすべてのアプリでは、ページ間のナビゲーションが必要です。 1 つのコンテンツページを持つ単純なアプリでも、通常はナビゲーションを必要とする設定ページが存在します。この記事では、XAML Page をアプリに追加し、 Frame を使用してページ間を移動する方法の基本について説明します。

重要

この例では、Microsoft Visual Studio の Blank App テンプレートを使用します。 Windows アプリ SDK/WinUI 3 アプリと UWP アプリのテンプレートには違いがあるため、アプリの種類に適したタブを選択してください。

Windows App SDK
UWP

適用対象: Windows アプリ SDK/WinUI3
重要な API: Microsoft.UI.Xaml.Controls.Frame クラス、 Microsoft.UI.Xaml.Controls.Page クラス、 Microsoft.UI.Xaml.Navigation 名前空間

Visual Studio で空のアプリを作成するには:

開発コンピューターをセットアップするには、「Windows App SDK 用のツールをインストールする」を参照してください。
Microsoft Visual Studio のスタートウィンドウで、 新しいプロジェクトの作成または Visual Studio メニューの File>New>Project を選択します。
新しいプロジェクトの作成ダイアログのドロップダウンフィルターで、それぞれ C# または C++、Windows、および WinUI を選択します。
プロジェクトテンプレートとして [空のアプリ、パッケージ (WinUI 3 in Desktop)] を選択し、[次へ] をクリックします。そのテンプレートで、WinUI 3 ベースのユーザーインターフェイスを使用したデスクトップアプリが作成されます。
[ プロジェクト名 ボックスに「 BasicNavigation」と入力し、[ Create をクリックします。
プログラムを実行するには、メニューから Debug>Start Debugging を選択するか、F5 キーを押します。開発用コンピューター上でソリューションをビルドして実行し、アプリがエラーなしで動作することを確認します。空白のページが表示されます。
デバッグを停止して Visual Studio に戻すには、アプリを終了するか、メニューから Stop Debugging をクリックします。
テンプレートに含まれているコード例を MainWindow.xaml から削除し、分離コードファイル MainWindow します。

ヒント

詳細については、「最初の WinUI 3 (Windows アプリ SDK) プロジェクトを作成するを参照してください。

Visual Studio で空のアプリを作成するには:

Microsoft Visual Studio のスタートウィンドウで、 新しいプロジェクトの作成または Visual Studio メニューの File>New>Project を選択します。
[新しいプロジェクトの作成ダイアログのドロップダウンフィルターで、それぞれ C# または C++、Windows、および UWP を選択します。
プロジェクトテンプレートの Blank App (ユニバーサル Windows) (C#) または Blank App (C++/WinRT)) 選択し、[次へ ] をクリック。
[ プロジェクト名 ボックスに「 BasicNavigation」と入力し、[ Create をクリックします。
[ 新しい Windows プロジェクト ] ダイアログで、 OK をクリックして、ターゲットと最小のプラットフォームバージョンの既定値をそのまま使用します。ソリューションが作成され、プロジェクトファイルがソリューションエクスプローラーに表示されます。
プログラムを実行するには、メニューから Debug>Start Debugging を選択するか、F5 キーを押します。開発用コンピューター上でソリューションをビルドして実行し、アプリがエラーなしで動作することを確認します。空白のページが表示されます。
デバッグを停止して Visual Studio に戻すには、アプリを終了するか、メニューから Stop Debugging をクリックします。

ヒント

For more info, see:

2. フレームを使用してページ間を移動する

アプリに複数のページがある場合は、 Frame を使用してページ間を移動します。 Frame クラスは、Navigate、GoBack、GoForward、プロパティ (BackStack、ForwardStack、BackStackDepth など) をサポート。

Windows App SDK
UWP

Visual Studio で新しいWindows アプリ SDK プロジェクトを作成すると、プロジェクトテンプレートによってMainWindow クラス (Microsoft.UI.Xaml.Window 型) が作成されます。ただし、 Frame または Page は作成せず、ナビゲーションコードも提供しません。

ページ間のナビゲーションを有効にするには、MainWindowのルート要素としてFrameを追加します。これは、App.xaml分離コードファイルの Application.OnLaunched メソッドのオーバーライドで行うことができます。 App分離コードファイルを開き、OnLaunchedのオーバーライドを更新し、次に示すように NavigationFailed イベントを処理します。

// App.xaml.cs

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();

    // Create a Frame to act as the navigation context and navigate to the first page
    Frame rootFrame = new Frame();
    rootFrame.NavigationFailed += OnNavigationFailed;
    // Navigate to the first page, configuring the new page
    // by passing required information as a navigation parameter
    rootFrame.Navigate(typeof(MainPage), args.Arguments);

    // Place the frame in the current Window
    m_window.Content = rootFrame;
    // Ensure the MainWindow is active
    m_window.Activate();
}

void OnNavigationFailed(object sender, NavigationFailedEventArgs e)
{
    throw new Exception("Failed to load Page " + e.SourcePageType.FullName);
}

// App.xaml.h

// Add after OnLaunched declaration.
void OnNavigationFailed(IInspectable const&, Microsoft::UI::Xaml::Navigation::NavigationFailedEventArgs const&);

///////////////
// App.xaml.cpp

void App::OnLaunched(LaunchActivatedEventArgs const& e)
{
    window = make<MainWindow>();
    Frame rootFrame = Frame();
    rootFrame.NavigationFailed({ this, &App::OnNavigationFailed });
    rootFrame.Navigate(xaml_typename<BasicNavigation::MainPage>(), box_value(e.Arguments()));
    window.Content(rootFrame);
    window.Activate();
}

void App::OnNavigationFailed(IInspectable const&, NavigationFailedEventArgs const& e)
{
    throw hresult_error(E_FAIL, hstring(L"Failed to load Page ") + e.SourcePageType().Name);
}

Note

より複雑なナビゲーションを使用するアプリの場合は、通常、MainWindow のルートとして NavigationView を使用し、ナビゲーションビューのコンテンツとして Frame を配置します。詳細については、「ナビゲーションビューを参照してください。

Visual Studio で新しい UWP プロジェクトを作成すると、プロジェクトテンプレートによってFrameが作成され、アプリの起動時にMainPageに移動するコードと共にMainPageされます。このコードは、App.xaml 分離コードファイルの Application.OnLaunched メソッドオーバーライドで作成されます。

ここでは、rootFrameと呼ばれるFrameが作成され、現在のウィンドウのコンテンツとして設定されます。次に、 Frame が MainPageに移動します。

protected override void OnLaunched(LaunchActivatedEventArgs e)
{
    Frame rootFrame = Window.Current.Content as Frame;

    // Do not repeat app initialization when the Window already has content,
    // just ensure that the window is active
    if (rootFrame == null)
    {
        // Create a Frame to act as the navigation context and navigate to the first page
        rootFrame = new Frame();

        rootFrame.NavigationFailed += OnNavigationFailed;

        if (e.PreviousExecutionState == ApplicationExecutionState.Terminated)
        {
            //TODO: Load state from previously suspended application
        }

        // Place the frame in the current Window
        Window.Current.Content = rootFrame;
    }

    if (e.PrelaunchActivated == false)
    {
        if (rootFrame.Content == null)
        {
            // When the navigation stack isn't restored navigate to the first page,
            // configuring the new page by passing required information as a navigation
            // parameter
            rootFrame.Navigate(typeof(MainPage), e.Arguments);
        }
        // Ensure the current window is active
        Window.Current.Activate();
    }
}

void OnNavigationFailed(object sender, NavigationFailedEventArgs e)
{
    throw new Exception("Failed to load Page " + e.SourcePageType.FullName);
}

// App.cpp

void App::OnLaunched(LaunchActivatedEventArgs const& e)
{
    Frame rootFrame{ nullptr };
    auto content = Window::Current().Content();
    if (content)
    {
        rootFrame = content.try_as<Frame>();
    }

    // Do not repeat app initialization when the Window already has content,
    // just ensure that the window is active
    if (rootFrame == nullptr)
    {
        // Create a Frame to act as the navigation context and associate it with
        // a SuspensionManager key
        rootFrame = Frame();

        rootFrame.NavigationFailed({ this, &App::OnNavigationFailed });

        if (e.PreviousExecutionState() == ApplicationExecutionState::Terminated)
        {
            // Restore the saved session state only when appropriate, scheduling the
            // final launch steps after the restore is complete
        }

        if (e.PrelaunchActivated() == false)
        {
            if (rootFrame.Content() == nullptr)
            {
                // When the navigation stack isn't restored navigate to the first page,
                // configuring the new page by passing required information as a navigation
                // parameter
                rootFrame.Navigate(xaml_typename<NavApp1::Page1>(), box_value(e.Arguments()));
            }
            // Place the frame in the current Window
            Window::Current().Content(rootFrame);
            // Ensure the current window is active
            Window::Current().Activate();
        }
    }
    else
    {
        if (e.PrelaunchActivated() == false)
        {
            if (rootFrame.Content() == nullptr)
            {
                // When the navigation stack isn't restored navigate to the first page,
                // configuring the new page by passing required information as a navigation
                // parameter
                rootFrame.Navigate(xaml_typename<NavApp1::Page1>(), box_value(e.Arguments()));
            }
            // Ensure the current window is active
            Window::Current().Activate();
        }
    }
}

void App::OnNavigationFailed(IInspectable const&, NavigationFailedEventArgs const& e)
{
    throw hresult_error(E_FAIL, hstring(L"Failed to load Page ") + e.SourcePageType().Name);
}

Navigate メソッドは、このFrame内のコンテンツを表示するために使用されます。ここでは、MainPage.xamlは Navigate メソッドに渡されるため、メソッドはFrameにMainPageを読み込みます。

アプリの初期ウィンドウへのナビゲーションが失敗すると、 NavigationFailed イベントが発生し、このコードはイベントハンドラーで例外をスローします。

3. 基本ページを追加する

Blank App テンプレートでは、複数のアプリページは作成されません。ページ間を移動する前に、いくつかのページをアプリに追加する必要があります。

Windows App SDK
UWP

アプリに新しい項目を追加するには:

ソリューションエクスプローラーで、BasicNavigation プロジェクトノードを右クリックしてコンテキストメニューを開きます。
コンテキストメニューから Add>New Item を選択します。
[ 新しい項目の追加 ] ダイアログボックスで、左側のウィンドウで WinUI ノードを選択し、中央のウィンドウで [ 空白ページ (WinUI 3) を選択します。
[ 名ボックスに「 MainPage 」と入力し、 Add ボタンを押します。
手順 1 から 4. を繰り返して 2 番目のページを追加しますが、[ 名ボックスに「 Page2」と入力します。

これらのファイルは、 BasicNavigation プロジェクトの一部として一覧表示されます。

C#	C++
MainPage.xaml MainPage.xaml.cs Page2.xaml Page2.xaml.cs	MainPage.xaml MainPage.xaml.cpp MainPage.xaml.h Page2.xaml Page2.xaml.cpp Page2.xaml.h

重要

C++ プロジェクトの場合別のページを参照する各ページのヘッダーファイルに #include ディレクティブを追加する必要があります。ここで示すページ間ナビゲーションの例では、mainpage.xaml.h ファイルに #include "Page2.xaml.h"が含まれています。さらに、page2.xaml.h には #include "MainPage.xaml.h"が含まれています。

C++ ページテンプレートには、ページの XAML ファイルと分離コードファイルから削除する必要がある Button およびクリックハンドラーコードの例も含まれています。

アプリに新しい項目を追加するには:

ソリューションエクスプローラーで、BasicNavigation プロジェクトノードを右クリックしてコンテキストメニューを開きます。
コンテキストメニューから Add>New Item を選択します。
[新しい項目の追加] ダイアログボックスで、次の手順を実行します。
- (C#) 左側のウィンドウで WinUI ノードを選択し、中央のウィンドウで [ 空白ページ (WinUI 3) を選択します。
- (C++/WinRT) 左側のウィンドウで Visual C++ ノードを選択し、中央のウィンドウで [ページ (C++/WinRT)] を選択します。
[ 名ボックスに「 Page2 」と入力し、 Add ボタンを押します。

これらのファイルは、 BasicNavigation プロジェクトの一部として一覧表示されます。

C#	C++
MainPage.xaml MainPage.xaml.cs Page2.xaml Page2.xaml.cs	MainPage.xaml MainPage.cpp MainPage.h Page2.xaml Page2.cpp Page2.h

重要

C++ プロジェクトの場合別のページを参照する各ページのヘッダーファイルに #include ディレクティブを追加する必要があります。ここで示すページ間ナビゲーションの例では、mainpage.h ファイルに #include "Page2.h"が含まれています。さらに、page2.h には #include "MainPage.h"が含まれています。

ページにコンテンツを追加する

MainPage.xamlで、既存のページコンテンツを次の内容に置き換えます。

<Grid>
    <TextBlock x:Name="pageTitle" Text="Main Page"
               Margin="16" Style="{StaticResource TitleTextBlockStyle}"/>
    <HyperlinkButton Content="Click to go to page 2"
                     Click="HyperlinkButton_Click"
                     HorizontalAlignment="Center"/>
</Grid>

この XAML では、次の内容が追加されます。

Text プロパティがルート Grid の子要素としてMain Pageに設定されたpageTitleという名前のTextBlock要素。
ルート Gridの子要素として次のページに移動するために使用されるHyperlinkButton要素。

MainPage分離コードファイルで、HyperlinkButton のClick イベントを処理する次のコードを追加します追加して、Page2.xamlへのナビゲーションを有効にします。

Windows App SDK
UWP

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2));
}

// pch.h
// Add this include in pch.h to support winrt::xaml_typename

#include <winrt/Windows.UI.Xaml.Interop.h>

////////////////////
// MainPage.xaml.h

void HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e);

////////////////////
// MainPage.xaml.cpp

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e)
{
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::Page2>());
}

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2));
}

// MainPage.h

void HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e);

///////////////
// MainPage.cpp

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e)
{
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::Page2>());
}

MainPage は、 Page クラスのサブクラスです。 Page クラスには、Pageを含むFrameを取得する読み取り専用の Frame プロパティがあります。 MainPage内のHyperlinkButtonのClick イベントハンドラーがFrame.Navigate(typeof(Page2))を呼び出すと、FrameはPage2.xamlの内容を表示します。

ページがフレームに読み込まれるたびに、そのページは PageStackEntry BackStack または Frame の ForwardStack に追加され、履歴と後方ナビゲーションが可能になります。

ここで、 Page2.xamlで同じ操作を行います。既存のページコンテンツを次の内容に置き換えます。

<Grid>
    <TextBlock x:Name="pageTitle" Text="Page 2"
               Margin="16" Style="{StaticResource TitleTextBlockStyle}"/>
    <HyperlinkButton Content="Click to go to main page"
                     Click="HyperlinkButton_Click"
                     HorizontalAlignment="Center"/>
</Grid>

Page2分離コードファイルで、HyperlinkButton のClick イベントを処理してMainPage.xamlに移動する次のコードを追加します。

Windows App SDK
UWP

// Page2.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(MainPage));
}

// Page2.xaml.h

void HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e);

/////////////////
// Page2.xaml.cpp

void winrt::BasicNavigation::implementation::Page2::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e)
{
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::MainPage>());
}

// Page2.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(MainPage));
}

// Page2.h

void HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e);

///////////////
// Page2.cpp

void winrt::BasicNavigation::implementation::Page2::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e)
{
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::MainPage>());
}

アプリをビルドし、実行します。 [クリックしてページ 2 に移動] というリンクをクリックします。上部に "Page 2" と表示されている 2 番目のページを読み込み、フレームに表示する必要があります。次に、ページ 2 のリンクをクリックしてメインページに戻ります。

4. ページ間で情報を渡す

アプリは 2 つのページ間を移動するようになりましたが、まだ興味深い操作は行われません。多くの場合、アプリに複数のページがある場合、ページは情報を共有する必要があります。次に、最初のページから 2 番目のページにいくつかの情報を渡します。

MainPage.xamlで、前に追加したHyperlinkButtonを次のStackPanelに置き換えます。これにより、テキスト文字列を入力するための TextBlock ラベルと TextBox name が追加されます。

<StackPanel VerticalAlignment="Center">
    <TextBlock HorizontalAlignment="Center" Text="Enter your name"/>
    <TextBox HorizontalAlignment="Center" Width="200" x:Name="name"/>
    <HyperlinkButton Content="Click to go to page 2"
                              Click="HyperlinkButton_Click"
                              HorizontalAlignment="Center"/>
</StackPanel>

次に、 Navigate メソッドの 2 番目のオーバーロードを使用し、テキストボックスから 2 番目のパラメーターとしてテキストを渡します。この Navigate オーバーロードのシグネチャを次に示します。

public bool Navigate(System.Type sourcePageType, object parameter);

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);

MainPage分離コードファイルのHyperlinkButton_Click イベントハンドラーで、name テキストボックスのText プロパティを参照する 2 つ目のパラメーターを Navigate メソッドに追加します。

Windows App SDK
UWP

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2), name.Text);
}

// MainPage.xaml.cpp

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e)
{ 
    Frame().Navigate(xaml_typename<BasicNavigation::Page2>(), winrt::box_value(name().Text()));
}

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2), name.Text);
}

// MainPage.cpp

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e)
{
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::Page2>(), winrt::box_value(name().Text()));
}

Page2.xamlで、前に追加したHyperlinkButtonを次のStackPanelに置き換えます。これにより、MainPageから渡されたテキスト文字列を表示するためのTextBlockが追加されます。

<StackPanel VerticalAlignment="Center">
    <TextBlock HorizontalAlignment="Center" x:Name="greeting"/>
    <HyperlinkButton Content="Click to go to page 1"
                     Click="HyperlinkButton_Click"
                     HorizontalAlignment="Center"/>
</StackPanel>

Page2分離コードファイルで、次のコードを追加して、OnNavigatedTo メソッドをオーバーライドします。

Windows App SDK
UWP

// Page2.xaml.cs

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    if (e.Parameter is string && !string.IsNullOrWhiteSpace((string)e.Parameter))
    {
        greeting.Text = $"Hello, {e.Parameter.ToString()}";
    }
    else
    {
        greeting.Text = "Hello!";
    }
    base.OnNavigatedTo(e);
}

// Page2.xaml.h

void Page2::OnNavigatedTo(Microsoft::UI::Xaml::Navigation::NavigationEventArgs const& e)
{
	auto propertyValue{ e.Parameter().as<Windows::Foundation::IPropertyValue>() };
	if (propertyValue.Type() == Windows::Foundation::PropertyType::String)
	{
		auto name{ winrt::unbox_value<winrt::hstring>(e.Parameter()) };
		if (!name.empty())
		{
			greeting().Text(L"Hello, " + name);
			__super::OnNavigatedTo(e);
			return;
		}
	}
	greeting().Text(L"Hello!");
	__super::OnNavigatedTo(e);
}

// Page2.xaml.cs

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    if (e.Parameter is string && !string.IsNullOrWhiteSpace((string)e.Parameter))
    {
        greeting.Text = $"Hello, {e.Parameter.ToString()}";
    }
    else
    {
        greeting.Text = "Hello!";
    }
    base.OnNavigatedTo(e);
}

// Page2.h

void Page2::OnNavigatedTo(Windows::UI::Xaml::Navigation::NavigationEventArgs const& e)
{
	auto propertyValue{ e.Parameter().as<Windows::Foundation::IPropertyValue>() };
	if (propertyValue.Type() == Windows::Foundation::PropertyType::String)
	{
		auto name{ winrt::unbox_value<winrt::hstring>(e.Parameter()) };
		if (!name.empty())
		{
			greeting().Text(L"Hello, " + name);
			__super::OnNavigatedTo(e);
			return;
		}
	}
	greeting().Text(L"Hello!");
	__super::OnNavigatedTo(e);
}

アプリを実行し、テキストボックスに自分の名前を入力し、 Click to go to page 2というリンクをクリックします。

MainPage内のHyperlinkButtonのClick イベントがFrame.Navigate(typeof(Page2), name.Text)を呼び出すと、name.Text プロパティがPage2に渡され、ページに表示されるメッセージにイベントデータの値が使用されます。

5. ページをキャッシュする

ページのコンテンツと状態は既定ではキャッシュされないため、情報をキャッシュする場合は、アプリの各ページで有効にする必要があります。

基本的なピアツーピアの例では、Page2の [Click to go to page 1] リンクをクリックすると、MainPageのTextBox (およびその他のフィールド) が既定の状態に設定されます。これを回避する方法の 1 つは、 NavigationCacheMode プロパティを使用して、フレームのページキャッシュにページを追加するように指定することです。

既定では、ナビゲーションが発生するたびに、既定値を使用して新しいページインスタンスが作成されます。 MainPage.xamlで、ページをキャッシュし、フレームのページキャッシュを超えるまでページのすべてのコンテンツと状態の値を保持するには、NavigationCacheModeを (開始Page タグ内の) Enabledに設定します。フレームキャッシュできるナビゲーション履歴のページ数を指定する CacheSize 制限を無視する場合はを Required に設定します。ただし、デバイスのメモリ制限によっては、キャッシュサイズの制限が重要になる可能性があることに注意してください。

<Page
    x:Class="BasicNavigation.MainPage"
    ...
    mc:Ignorable="d"
    NavigationCacheMode="Enabled">

メインページに戻ると、テキストボックスに入力した名前がまだ表示されます。

6. ページ切り替えアニメーションをカスタマイズする

既定では、ナビゲーションが発生すると、各ページがフレームにアニメーション化されます。既定のアニメーションは、ウィンドウの下部からページを上にスライドさせる "開始" アニメーションです。ただし、アプリのナビゲーションに適したさまざまなアニメーションオプションを選択できます。たとえば、"ドリルイン" アニメーションを使用して、ユーザーがアプリに深く入り込んでいるような感覚を与えたり、水平スライドアニメーションを使用して 2 つのページがピアであるという感覚を与えたりすることができます。詳細については、「ページ切り替え」を参照してください。

これらのアニメーションは、 NavigationTransitionInfo のサブクラスによって表されます。ページ切り替えに使用するアニメーションを指定するには、Navigate メソッドの 3 番目のオーバーロードを使用し、3 番目のパラメーター (infoOverride) としてNavigationTransitionInfoのサブクラスを渡します。この Navigate オーバーロードのシグネチャを次に示します。

public bool Navigate(System.Type sourcePageType, 
                     object parameter,
                     NavigationTransitionInfo infoOverride);

bool Navigate(TypeName const& sourcePageType, 
              IInspectable const& parameter, 
              NavigationTransitionInfo const& infoOverride);

MainPage分離コードファイルのHyperlinkButton_Click イベントハンドラーで、infoOverride パラメーターを SlideNavigationTransitionInfo に設定する 3 番目のパラメーターを Navigate メソッドに追加 Effect プロパティを FromRight に設定します。

Windows App SDK
UWP

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2), 
                   name.Text,
                   new SlideNavigationTransitionInfo() 
                       { Effect = SlideNavigationTransitionEffect.FromRight});
}

// pch.h

#include <winrt/Microsoft.UI.Xaml.Media.Animation.h>

////////////////////
// MainPage.xaml.cpp

using namespace winrt::Microsoft::UI::Xaml::Media::Animation;

// ...

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e)
{   
    // Create the slide transition and set the transition effect to FromRight.
    SlideNavigationTransitionInfo slideEffect = SlideNavigationTransitionInfo();
    slideEffect.Effect(SlideNavigationTransitionEffect(SlideNavigationTransitionEffect::FromRight));
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::Page2>(),
        		     winrt::box_value(name().Text()),
                     slideEffect);
}

// MainPage.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(Page2), 
                   name.Text,
                   new SlideNavigationTransitionInfo()
                       { Effect = SlideNavigationTransitionEffect.FromRight});
}

// pch.h

#include <winrt/Windows.UI.Xaml.Media.Animation.h>

///////////////
// MainPage.cpp

using namespace winrt::Windows::UI::Xaml::Media::Animation;

// ...

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e)
{   
    // Create the slide transition and set the transition effect to FromRight.
    SlideNavigationTransitionInfo slideEffect = SlideNavigationTransitionInfo();
    slideEffect.Effect(SlideNavigationTransitionEffect(SlideNavigationTransitionEffect::FromRight));
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::Page2>(),
        		     winrt::box_value(name().Text()),
                     slideEffect);
}

Page2分離コードファイルのHyperlinkButton_Click イベントハンドラーで、infoOverride パラメーターを SlideNavigationTransitionInfo Effect プロパティを FromLeft に設定します。

Windows App SDK
UWP

// Page2.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(MainPage),
                   null,
                   new SlideNavigationTransitionInfo() 
                       { Effect = SlideNavigationTransitionEffect.FromLeft});
}

// Page2.xaml.cpp

using namespace winrt::Microsoft::UI::Xaml::Media::Animation;

// ...

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Microsoft::UI::Xaml::RoutedEventArgs const& e)
{   
    // Create the slide transition and set the transition effect to FromLeft.
    SlideNavigationTransitionInfo slideEffect = SlideNavigationTransitionInfo();
    slideEffect.Effect(SlideNavigationTransitionEffect(SlideNavigationTransitionEffect::FromLeft));
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::MainPage>(),
        		     nullptr,
                     slideEffect);
}

// Page2.xaml.cs

private void HyperlinkButton_Click(object sender, RoutedEventArgs e)
{
    Frame.Navigate(typeof(MainPage),
                   null,
                   new SlideNavigationTransitionInfo() 
                       { Effect = SlideNavigationTransitionEffect.FromLeft});
}

// Page2.cpp

using namespace winrt::Windows::UI::Xaml::Media::Animation;

// ...

void winrt::BasicNavigation::implementation::MainPage::HyperlinkButton_Click(winrt::Windows::Foundation::IInspectable const& sender, winrt::Windows::UI::Xaml::RoutedEventArgs const& e)
{   
    // Create the slide transition and set the transition effect to FromLeft.
    SlideNavigationTransitionInfo slideEffect = SlideNavigationTransitionInfo();
    slideEffect.Effect(SlideNavigationTransitionEffect(SlideNavigationTransitionEffect::FromLeft));
    Frame().Navigate(winrt::xaml_typename<BasicNavigation::MainPage>(),
        		     nullptr,
                     slideEffect);
}

ページ間を移動すると、ページが左右にスライドします。これにより、この切り替えにより自然な感覚が得られ、ページ間の接続が強化されます。

次の方法で共有

2 ページ間のナビゲーションを実装する

1. 空のアプリを作成する

2. フレームを使用してページ間を移動する

3. 基本ページを追加する

ページにコンテンツを追加する

4. ページ間で情報を渡す

5. ページをキャッシュする

6. ページ切り替えアニメーションをカスタマイズする

その他のリソース

次の方法で共有

2 ページ間のナビゲーションを実装する

1. 空のアプリを作成する

2. フレームを使用してページ間を移動する

3. 基本ページを追加する

ページにコンテンツを追加する

4. ページ間で情報を渡す

5. ページをキャッシュする

6. ページ切り替えアニメーションをカスタマイズする

関連記事

その他のリソース