AppWindow クラス

定義

アプリのコンテンツのシステム管理コンテナーを表します。

public ref class AppWindow sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppWindow final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppWindow
Public NotInheritable Class AppWindow
継承
Object Platform::Object IInspectable AppWindow
属性

注釈

Important

タイトル バーのカスタマイズ API は、Windows アプリ SDK 1.2 以降、Windows 10で部分的にサポートされ、Windows 11で完全にサポートされています。 これらの API を呼び出す前に、コードで AppWindowTitleBar.IsCustomizationSupported を確認し、他のバージョンのWindowsでアプリがクラッシュしないようにする必要があります。 詳細については、「 タイトル バーのカスタマイズ 」を参照してください。

プロパティ

名前 説明
ClientSize

Win32 クライアント座標のウィンドウのクライアント領域の現在のサイズを取得します。

DispatcherQueue

アプリ ウィンドウに関連付けられているディスパッチャー キューを取得します。

Id

アプリ ウィンドウの識別子を取得します。

IsShownInSwitchers

Alt + TAB やタスク バーなど、さまざまなシステム表現でこのウィンドウが表示されるかどうかを示す値を取得または設定します。

IsVisible

ウィンドウが表示されるかどうかを示す値を取得します。

OwnerWindowId

このウィンドウの所有者の識別子を取得します。所有されていない場合は 0。

PersistedStateId

アプリのコンテンツのシステム管理コンテナーを表します。

PlacementRestorationBehavior

アプリのコンテンツのシステム管理コンテナーを表します。

Position

画面座標でのウィンドウの現在位置を取得します。

Presenter

アプリ ウィンドウに現在適用されている発表者を取得します。

Size

画面座標でのウィンドウの現在のサイズを取得します。

Title

アプリ ウィンドウの表示タイトルを取得または設定します。

TitleBar

アプリ ウィンドウのタイトル バーを取得します。

メソッド

名前 説明
AssociateWithDispatcherQueue(DispatcherQueue)

指定したディスパッチャー キューにアプリ ウィンドウを関連付けます。

Create()

既定の OverlappedPresenterのスタイルとプロパティに設定されたアプリ ウィンドウを作成します。

Create(AppWindowPresenter, WindowId, DispatcherQueue)

指定した AppWindowPresenterで定義され、指定したウィンドウに親され、指定した DispatcherQueueに関連付けられているスタイルとプロパティを持つウィンドウを作成します。

Create(AppWindowPresenter, WindowId)

指定した AppWindowPresenter で定義され、指定したウィンドウに親されているスタイルとプロパティを持つウィンドウを作成します。

Create(AppWindowPresenter)

指定した AppWindowPresenterで定義されているスタイルとプロパティを含むウィンドウを作成します。

Destroy()

アプリ ウィンドウの破棄を試みます。

GetCurrentPlacement()

アプリのコンテンツのシステム管理コンテナーを表します。

GetFromWindowId(WindowId)

指定したWindowIdを持つAppWindow (使用可能な場合) を返します。 WindowIdが有効なウィンドウと一致しない場合は、nullを返します。

Hide()

システム内のすべての UX 表現からウィンドウを非表示にしますが、オブジェクトは維持されます。

Move(PointInt32)

画面座標の指定したポイントにウィンドウを移動します。

MoveAndResize(RectInt32, DisplayArea)

指定した表示領域内の指定したポイントにウィンドウを移動し、指定したサイズに設定します。

MoveAndResize(RectInt32)

画面座標内の指定したポイントにウィンドウを移動し、指定したサイズに設定します。

MoveInZOrderAtBottom()

現在のウィンドウを Z オーダーの下部ウィンドウに移動します。

MoveInZOrderAtTop()

現在のウィンドウを Z オーダーの一番上のウィンドウに移動します。

MoveInZOrderBelow(WindowId)

現在のウィンドウを Z オーダーで指定したウィンドウの下に移動します。

Resize(SizeInt32)

ウィンドウのサイズを指定したサイズに変更します。

ResizeClient(SizeInt32)

クライアント領域の指定したサイズに合わせてウィンドウのサイズを変更します。

SaveCurrentPlacement()

アプリのコンテンツのシステム管理コンテナーを表します。

SaveCurrentPlacementForAllPersistedStateIds()

アプリのコンテンツのシステム管理コンテナーを表します。

SetCurrentPlacement(AppWindowPlacementDetails, Boolean)

アプリのコンテンツのシステム管理コンテナーを表します。

SetIcon(IconId)

指定したアイコン ID を使用して、ウィンドウのアイコンを設定します。

SetIcon(String)

指定したアイコン パスを使用して、ウィンドウのアイコンを設定します。

SetPresenter(AppWindowPresenter)

指定した発表者をウィンドウに適用します。

SetPresenter(AppWindowPresenterKind)

指定した発表者の種類をウィンドウに適用します。

SetTaskbarIcon(IconId)

指定したアイコン ID を使用してタスク バーのアイコンを設定します。

SetTaskbarIcon(String)

指定したアイコン パスを使用してタスク バーのアイコンを設定します。

SetTitleBarIcon(IconId)

指定したアイコン ID を使用して、ウィンドウ タイトル バーのアイコンを設定します。

SetTitleBarIcon(String)

指定したアイコン パスを使用して、ウィンドウ タイトル バーのアイコンを設定します。

Show()

ウィンドウを表示し、アクティブにします。

Show(Boolean)

ウィンドウをアクティブ化するかどうかのオプションが表示されます。

ShowOnceWithRequestedStartupState()

要求された状態の既定の発表者を含むウィンドウを表示します。

イベント

名前 説明
Changed

ウィンドウのプロパティが変更され、当分の間、システムが "安定状態" の場合に発生します。

Closing

システム アフォーダンスによってウィンドウが閉じられているときに発生します。

Destroying

ウィンドウが破棄されるときに発生します。

適用対象

こちらもご覧ください