次の方法で共有


ApplicationView クラス

定義

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

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
属性

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後にリリースで変更または使用できない場合があります。 代わりに、 TryEnterFullScreenModeFullScreenSystemOverlayMode を使用します。

システム オーバーレイ (オーバーレイ アプリケーションやソフト ステアリング ホイールなど) を表示するかどうかを示す値を取得または設定します。

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 の値が変更されたときに発生します。通常は、ステータス バー、アプリ バー、またはその他のクロムが表示または非表示になった結果として発生します。

適用対象

こちらもご覧ください