Window クラス

定義

名前空間:

Windows.UI.Xaml

アプリケーション ウィンドウを表します。

public ref class Window 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 Window 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 Window

Public NotInheritable Class Window

継承

Object Platform::Object IInspectable Window

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

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

例

次のコード例は、Microsoft Visual Studio の空のアプリケーション テンプレートに対して生成 された OnLaunched メソッドオーバーライドを示しています。 このコードでは、 Current プロパティと Content プロパティと Activate メソッドの一般的な使用パターンを示します。

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

注釈

このクラスは、現在の Application のウィンドウを表します。 静的 Application プロパティと同じ方法で、静的 Current プロパティはアプリ ウィンドウ オブジェクトを返します。 このオブジェクトから、アプリは Dispatcher を利用するか、 Bounds プロパティから Window のサイズを決定できます。 Window の最も一般的な使用方法は、アプリ UI を表すコンテンツに UIElement を設定することです。 これは通常、アプリのアクティブ化の一環として行われます ( OnLaunched オーバーライドなど)。このウィンドウの内容は、ウィンドウの有効期間を通して変更できます。

Window クラスはコントロールではないので、XAML 表現はありません。

Window オブジェクトは CoreWindow から情報を表示しているだけで、システムによって作成されたウィンドウが参照されます。

最初の アクティブ化 で使用する任意のウィンドウで Activate を呼び出してください。 Microsoft Visual Studio から既定のアプリ テンプレートを使用する場合、 Window.Activate の呼び出しは app.xaml 分離コード ファイルの初期コードの一部です。

Microsoft Visual Studio の一部のアプリケーション テンプレートの一部である LayoutAwarePage クラスには、ApplicationViewState の値に一致する視覚的な状態を追跡するために使用される SizeChanged イベントの処理があります。 LayoutAwarePage には 、境界 をチェックし、この値を使用してページ全体の入力イベントの処理方法に影響を与えるコードもあります。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	Compositor
1903	18362	UIContext

追加のインターフェイス メンバー

IXamlSourceTransparency.IsBackgroundTransparent

現在のスレッド上のすべての DesktopWindowXamlSource オブジェクトの背景が透明かどうかを示す値を取得または設定します。

プロパティ

Bounds	デバイスに依存しないピクセル (DIP) で、ウィンドウのクライアント領域の原点、高さ、幅を含む Rect 値を取得します。
Compositor	このウィンドウの コンポジター を取得します。
Content	アプリケーション ウィンドウのビジュアル ルートを取得または設定します。
CoreWindow	アプリケーション ウィンドウの内部 コア オブジェクトを取得します。
Current	現在のスレッドのウィンドウを取得します。
Dispatcher	Window の CoreDispatcher オブジェクトを取得します。これは通常、UI スレッドの CoreDispatcher です。
UIContext	ウィンドウのコンテキスト識別子を取得します。
Visible	ウィンドウが表示されているかどうかを報告する値を取得します。

メソッド

Activate()	アプリケーション ウィンドウをフォアグラウンドに移動し、入力フォーカスを設定して、アプリケーション ウィンドウのアクティブ化を試みます。
Close()	アプリケーション ウィンドウを閉じます。
SetTitleBar(UIElement)	XAML 要素をタイトル バーのようにシステムと対話させます。

イベント

Activated	ウィンドウが正常にアクティブ化されたときに発生します。
Closed	ウィンドウが閉じられたときに発生します。
SizeChanged	アプリ ウィンドウが最初にレンダリングされたとき、またはレンダリング サイズが変更されたときに発生します。
VisibilityChanged	Visible プロパティの値が変更されたときに発生します。

こちらもご覧ください

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• アプリのアクティブ化の処理