ApplicationView クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アクティブなアプリケーション ビューと、関連付けられている状態と動作を表します。
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 ApplicationViewPublic NotInheritable Class ApplicationView- 継承
- 属性
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 の値が変更されたときに発生します。通常は、ステータス バー、アプリ バー、またはその他のクロムが表示または非表示になった結果として発生します。 |