ApplicationView を使用して複数のビューを表示する

[アーティクル]
06/02/2023

アプリの独立した部分を別々のウィンドウで表示できるようにすることは、ユーザーが生産性を高めるために役立ちます。アプリの複数のウィンドウを作成すると、各ウィンドウは別々に動作します。タスクバーには各ウィンドウが別々に表示されます。ユーザーはアプリウィンドウの移動、サイズ変更、表示、非表示を個別に行うことができます。また、個別のアプリの場合と同じように各アプリウィンドウを切り替えることができます。各ウィンドウは、独自のスレッドで動作します。

重要な API: ApplicationViewSwitcher、CreateNewView

ビューとは

アプリのビューは、スレッドとウィンドウが 1:1 で対応したもので、アプリがコンテンツの表示に使います。ビューは Windows.ApplicationModel.Core.CoreApplicationView オブジェクトによって表現されます。

また、CoreApplication オブジェクトによって管理されます。 CoreApplication.CreateNewView を呼び出して、CoreApplicationView オブジェクトを作成できます。 CoreApplicationView は CoreWindow と CoreDispatcher (CoreWindow プロパティと Dispatcher プロパティに格納) を関連付けます。 CoreApplicationView は、Windows ランタイムがコア Windows システムとのやり取りに使うオブジェクトとして考えることができます。

通常は CoreApplicationView を直接操作しません。代わりに Windows ランタイムでは、ApplicationView クラスは Windows.UI.ViewManagement 名前空間にあります。このクラスには、アプリがウィンドウシステムとのやり取りに使うプロパティ、メソッド、イベントが用意されています。 ApplicationView を操作するには、静的メソッド ApplicationView.GetForCurrentView を呼び出して、現在の CoreApplicationView のスレッドに関連付けられている ApplicationView インスタンスを取得します。

同様に、XAML フレームワークは CoreWindow オブジェクトを Windows.UI.XAML.Window オブジェクトにラップします。 XAML アプリでは通常、CoreWindow を直接操作しないで、Window オブジェクトを操作します。

新しいビューの表示

各アプリのレイアウトはそれぞれ異なりますが、「新しいウィンドウ」ボタンを予測可能な場所に含めることを推奨します。たとえば、新しいウィンドウで開くことができるコンテンツの右上隅などです。さらに、[新しいウィンドウで開く] ためのコンテキストメニューオプションを含めることを検討します。

新しいビューを作成する手順を見てみましょう。ここでは、新しいビューがボタンのクリックに応じて起動されます。

private async void Button_Click(object sender, RoutedEventArgs e)
{
    CoreApplicationView newView = CoreApplication.CreateNewView();
    int newViewId = 0;
    await newView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        Frame frame = new Frame();
        frame.Navigate(typeof(SecondaryPage), null);   
        Window.Current.Content = frame;
        // You have to activate the window in order to show it later.
        Window.Current.Activate();

        newViewId = ApplicationView.GetForCurrentView().Id;
    });
    bool viewShown = await ApplicationViewSwitcher.TryShowAsStandaloneAsync(newViewId);
}

新しいビューを表示するには

CoreApplication.CreateNewView を呼び出して、ビューコンテンツに使う新しいウィンドウとスレッドを作成します。
```
CoreApplicationView newView = CoreApplication.CreateNewView();
```
新しいビューの Id を記録します。これは後でビューの表示に使います。

作成するビューの追跡に役立つ何らかのインフラストラクチャをアプリに構築することを検討することもできます。例については、ViewLifetimeControlMultipleViews サンプルのクラスを参照してください。
```
int newViewId = 0;
```
新しいスレッドで、ウィンドウにコンテンツを読み込みます。

CoreDispatcher.RunAsync メソッドを使って、UI スレッドでの新しいビューの操作をスケジュールします。ラムダ式を使って、RunAsync メソッドの引数として関数を渡します。ラムダ関数による操作は新しいビューのスレッドで実行されます。

XAML では通常、Window の Content プロパティに Frame を追加した後、Frame から、アプリのコンテンツを定義した XAML Page に移ります。フレームとページの詳細については、2 ページ間でのピアツーピアのナビゲーションに関するページを参照してください。

新しい Window にコンテンツが読み込まれたら、後で Window を表示するには、Window の Activate メソッドを呼び出す必要があります。この操作は新しいビューのスレッドで実行されるため、新しい Window がアクティブになります。

最後に、後でビューの表示に使う新しいビューの Id を取得します。やはり、この操作も新しいビューのスレッドで実行されるため、ApplicationView.GetForCurrentView は新しいビューの Id を取得します。
```
await newView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
    Frame frame = new Frame();
    frame.Navigate(typeof(SecondaryPage), null);   
    Window.Current.Content = frame;
    // You have to activate the window in order to show it later.
    Window.Current.Activate();

    newViewId = ApplicationView.GetForCurrentView().Id;
});
```
ApplicationViewSwitcher.TryShowAsStandaloneAsync を呼び出して、新しいビューを表示します。

新しいビューを作成したら、ApplicationViewSwitcher.TryShowAsStandaloneAsync メソッドを呼び出して、そのビューを新しいウィンドウに表示できます。このメソッドの viewId パラメーターはアプリの各ビューを一意に識別する整数です。ビュー Id は、ApplicationView.Id プロパティまたは ApplicationView.GetApplicationViewIdForWindow メソッドを使って取得できます。
```
bool viewShown = await ApplicationViewSwitcher.TryShowAsStandaloneAsync(newViewId);
```

メインビュー

アプリの起動時に最初に作成されるビューは、メインビューと呼ばれます。このビューは、CoreApplication.MainView プロパティに格納され、その IsMain プロパティは true です。このビューは作成しません。アプリによって作成されます。メインビューのスレッドはアプリのマネージャーとして機能し、すべてのアプリの起動イベントはこのスレッドに振り分けられます。

セカンダリビューが開いている場合は、ウィンドウのタイトルバーの閉じるボタン (x) をクリックするなどして、メインビューのウィンドウを非表示にすることができます。ただし、そのスレッドはアクティブのままになります。メインビューの Window で Close を呼び出すと、InvalidOperationException が発生します (Application.Exit を使ってアプリを閉じます)。メインビューのスレッドが終了した場合、アプリは終了します。

セカンダリビュー

アプリのコードで CreateNewView を呼び出すことで作成するすべてのビューなど、その他のビューがセカンダリビューです。メインビューとセカンダリビューの両方が CoreApplication.Views コレクションに格納されます。通常、ユーザーの操作に応じてセカンダリビューを作成します。システムによってアプリのセカンダリビューが作成される場合もあります。

注意

Windows の割り当てられたアクセス機能を使うと、キオスクモードでアプリを実行できます。この場合、システムによってロック画面に、アプリの UI を表示するセカンダリビューが作成されます。アプリによるセカンダリビューの作成は許可されないため、キオスクモードで独自のセカンダリビューを表示しようとすると、例外がスローされます。

ビュー間の切り替え

ユーザーには、セカンダリウィンドウから親ウィンドウに戻る方法を提供することを検討します。そのためには、ApplicationViewSwitcher.SwitchAsync メソッドを使用します。このメソッドを切り替え元のウィンドウのスレッドから呼び出し、切り替え先のウィンドウのビュー ID を渡します。

await ApplicationViewSwitcher.SwitchAsync(viewIdToShow);

SwitchAsync を使うときは、ApplicationViewSwitchingOptions の値を指定することで、最初のウィンドウを閉じてタスクバーから削除するかどうかを選べます。

ApplicationView を使用して複数のビューを表示する

ビューとは

新しいビューの表示

メインビュー

セカンダリビュー

ビュー間の切り替え

フィードバック

その他のリソース

ApplicationView を使用して複数のビューを表示する

ビューとは

新しいビューの表示

メイン ビュー

セカンダリ ビュー

ビュー間の切り替え

関連トピック

フィードバック

その他のリソース

メインビュー

セカンダリビュー