ApplicationView クラス

定義

名前空間:

Windows.UI.ViewManagement

アクティブなアプリケーション ビューと、関連付けられている状態と動作を表します。

public ref class ApplicationView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ApplicationView

Public NotInheritable Class ApplicationView

継承

Object Platform::Object IInspectable ApplicationView

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

ウィンドウ (アプリ ビューとも呼ばれます) は、Windows ランタイム アプリの表示部分です。 Windows では、ユーザーの画面には最大 4 つの可変幅ウィンドウを同時に表示できます。 それらは重ならず、上端と下端が画面の上端と下端に接します。 隣接するウィンドウの間にウィンドウ以外の領域がある場合があります。

ウィンドウは、アプリケーションの現在のページと同じではありません。 ページのコンテナーと考える方が良いです。アプリケーションのすべてのページに対して、プログラムでウィンドウ参照を使用できます。

各ウィンドウには、ウィンドウの UI 処理スレッド (コア入力ハンドラーとイベント ディスパッチャーを含む) を表す対応する CoreWindow があります。

ページの構成では、ウィンドウのプロパティ (JavaScript の場合はメソッド) を使用できます。 たとえば、 Orientation プロパティは、ウィンドウが縦または横のどちらであるかを示します。Windows の 場合、AdjacentToLeftDisplayEdge プロパティは、画面の左端がウィンドウの左罫線であるかどうかを示します。 isFullScreen メソッドは、ウィンドウで画面全体を使用するかどうかを示します。 これらのメソッドの使用例については、 アプリケーション ビュー のサンプルを参照してください。

この型のオブジェクトを取得するには、 ApplicationView.GetForCurrentView を呼び出します。

注意

ページ レイアウトの作成時に ApplicationView.Value プロパティで返される値を使用しないでください。 このメソッドは非推奨であり、今後のリリースでは使用できない可能性があります。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	IsViewModeSupported
1703	15063	TryConsolidateAsync
1703	15063	TryEnterViewModeAsync(ApplicationViewMode)
1703	15063	TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
1703	15063	ViewMode
1903	18362	ClearAllPersistedState
1903	18362	ClearPersistedState
1903	18362	GetDisplayRegions
1903	18362	PersistedStateId
1903	18362	UIContext
1903	18362	WindowingEnvironment

プロパティ

AdjacentToLeftDisplayEdge	現在のウィンドウが画面の左端に近接しているかどうかを示す値を取得します。
AdjacentToRightDisplayEdge	現在のウィンドウが画面の右端に近接しているかどうかを示す値を取得します。
DesiredBoundsMode	ウィンドウの内容をレイアウトするためにフレームワークによって使用される境界 (アプリ ビュー) を示す値を取得します。
FullScreenSystemOverlayMode	全画面表示モードのアプリがエッジ スワイプ アクションにどのように応答するかを示す値を取得または設定します。
Id	ウィンドウ (アプリ ビュー) の ID を取得します。
IsFullScreen	注意 IsFullScreen は、Windows 10後にリリースで変更または使用できない場合があります。 代わりに、 IsFullScreenMode を使用します。 ウィンドウがディスプレイの左右の両方に触れるかどうかを示す値を取得します。
IsFullScreenMode	アプリが全画面表示モードで実行されているかどうかを示す値を取得します。
IsOnLockScreen	ウィンドウ (アプリ ビュー) が Windows ロック画面にあるかどうかを取得します。
IsScreenCaptureEnabled	ウィンドウ (アプリ ビュー) に対して画面キャプチャを有効にするかどうかを取得または設定します。
Orientation	表示に関するウィンドウ (アプリ ビュー) の現在の向き (横または縦) を取得します。
PersistedStateId	状態を追跡および保存するために、このビューを識別する文字列を取得または設定します。
PreferredLaunchViewSize	ApplicationView.PreferredLaunchWindowingMode プロパティが PreferredLaunchViewSize に設定されている場合に、システムがウィンドウ サイズを直接管理する場合を除き、アプリが起動するサイズを取得または設定します。
PreferredLaunchWindowingMode	アプリが起動するウィンドウ モードを示す値を取得または設定します。
SuppressSystemOverlays	注意 SuppressSystemOverlays は、Windows 10後にリリースで変更または使用できない場合があります。 代わりに、 TryEnterFullScreenMode と FullScreenSystemOverlayMode を使用します。 システム オーバーレイ (オーバーレイ アプリケーションやソフト ステアリング ホイールなど) を表示するかどうかを示す値を取得または設定します。
TerminateAppOnFinalViewClose	最後のウィンドウが閉じられたときにアプリを終了するかどうかを示します。
Title	ウィンドウの表示タイトルを取得または設定します。
TitleBar	アプリのタイトル バーを取得します。
UIContext	ビューのコンテキスト識別子を取得します。
Value	注意 ApplicationView 静的メソッドは、Windows 8.1後にリリースで変更または使用できない場合があります。 代わりに、 ApplicationView.GetForCurrentView を使用して ApplicationView オブジェクトを取得します。 現在のウィンドウ (アプリ ビュー) の状態を取得します。
ViewMode	現在のビューのアプリ ビュー モードを取得します。
VisibleBounds	ウィンドウ (アプリ ビュー) の表示領域を取得します。 表示されているリージョンは、ステータス バーやアプリ バーなどのクロムによって隠されていないリージョンです。
WindowingEnvironment	ビューのウィンドウ環境を取得します。

メソッド

ClearAllPersistedState()	特定のアプリケーションの PersistedStateId ビューに対してシステムが保存したすべてのプロパティをクリアします。
ClearPersistedState(String)	指定されたアプリケーションの指定した識別子を使用して、ビューに対してシステムが保存したプロパティをすべてクリアします。
ExitFullScreenMode()	アプリを全画面表示モードから切り替えます。
GetApplicationViewIdForWindow(ICoreWindow)	アプリによって管理される特定の CoreWindow に対応するウィンドウ ID を取得します。
GetDisplayRegions()	ビューで使用できる表示領域のコレクションを返します。
GetForCurrentView()	アクティブなアプリケーションのビューの状態と動作の設定を取得します。
IsViewModeSupported(ApplicationViewMode)	指定したビュー モードが現在のデバイスでサポートされているかどうかを判断します。
SetDesiredBoundsMode(ApplicationViewBoundsMode)	ウィンドウ (アプリ ビュー) の内容をレイアウトするためにフレームワークで使用される境界を示す値を設定します。
SetPreferredMinSize(Size)	アプリ ウィンドウで許可される最小サイズを有効ピクセル単位で設定します。
ShowStandardSystemOverlays()	全画面表示アプリの上に、タイトル バーなどのシステム UI 要素を表示します。
TryConsolidateAsync()	現在のアプリ ビューの非表示を試みます。 このメソッドは、アプリを閉じるユーザーに相当するプログラムです。
TryEnterFullScreenMode()	アプリを全画面表示モードで配置しようとします。
TryEnterViewModeAsync(ApplicationViewMode)	アプリ ビューを指定したビュー モードに変更しようとします。
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	指定したオプションを使用して、アプリ ビューを指定したビュー モードに変更しようとします。
TryResizeView(Size)	ビューのサイズを有効ピクセル単位で指定したサイズに変更しようとします。
TryUnsnap()	注意 tryUnsnap は、Windows 8.1後にリリースで変更または使用できない場合があります。 アプリのサイズは継続的に変更できますが、Windows 8.1以降はスナップできません。 また、ApplicationView 静的メソッドは、Windows 8.1後にリリースで変更または使用できない場合があります。 ApplicationView オブジェクトを取得するには、ApplicationView.GetForCurrentViewを使用します。 以前にスナップされたアプリのスナップ解除を試みます。 この呼び出しは、アプリがフォアグラウンドで実行されている場合にのみ成功します。
TryUnsnapToFullscreen()	以前にスナップされたアプリのスナップ解除を試みます。

イベント

Consolidated	ウィンドウが最近使用したアプリの一覧から削除されたとき、またはユーザーが閉じたジェスチャを実行したときに発生します。
VisibleBoundsChanged	このイベントは、 VisibleBounds の値が変更されたときに発生します。通常は、ステータス バー、アプリ バー、またはその他のクロムが表示または非表示になった結果として発生します。

こちらもご覧ください

• 画面キャプチャ サンプルの無効化 (Windows 10)
• ユーザー操作モードのサンプル (Windows 10)
• 複数のビューのサンプル (Windows 10)
• 全画面表示モードのサンプル (Windows 10)
• ウィンドウのサイズ変更のサンプル (Windows 10)
• タイトル バーのサンプル (Windows 10)