Window クラス

定義

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

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

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

WindowCoreDispatcher オブジェクトを取得します。これは通常、UI スレッドの CoreDispatcher です。

UIContext

ウィンドウのコンテキスト識別子を取得します。

Visible

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

メソッド

Activate()

アプリケーション ウィンドウをフォアグラウンドに移動し、入力フォーカスを設定して、アプリケーション ウィンドウのアクティブ化を試みます。

Close()

アプリケーション ウィンドウを閉じます。

SetTitleBar(UIElement)

XAML 要素をタイトル バーのようにシステムと対話させます。

イベント

Activated

ウィンドウが正常にアクティブ化されたときに発生します。

Closed

ウィンドウが閉じられたときに発生します。

SizeChanged

アプリ ウィンドウが最初にレンダリングされたとき、またはレンダリング サイズが変更されたときに発生します。

VisibilityChanged

Visible プロパティの値が変更されたときに発生します。

適用対象

こちらもご覧ください