Window クラス

リファレンス

定義

名前空間:: Microsoft.UI.Xaml

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window

Public Class Window

継承: Object IInspectable Window

属性: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

OnLaunched

次のコード例は、Microsoft Visual Studio のデスクトップテンプレートの WinUI に対して生成された OnLaunched メソッドのオーバーライドを示しています。このコードは、の Activate メソッドの一般的な使用方法を Window示しています。

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

新しいウィンドウを作成する

アプリでは、各ウィンドウを明示的に作成できます。複数のウィンドウを作成するには、WindowsAppSDK に対する 1.0.1 更新プログラムが必要であり、1 つのスレッドに制限されます。

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

マークアップで新しいウィンドウを定義することもできます。

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

対応する分離コード:

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
var window = new MainWindow();
window.Activate();

注釈

アプリでは、スレッドごとに複数 Window のを作成できます。「例」の「新しいウィンドウを作成する」を参照してください。

Windowは、ウィンドウの HWND (WindowHandle) を介した相互運用を有効にする IWindowNative を実装します。

通常、は、Windowアプリ UI を表す Content に UIElement を設定するために使用されます。これは通常、アプリのアクティブ化 ( OnLaunched オーバーライドなど) の一環として行われ、ウィンドウの有効期間を通じてウィンドウの内容を変更できます。

最初のアクティブ化で使用した場合は Window 、必ず Activate を呼び出してください。 Microsoft Visual Studio の既定のアプリテンプレートを使用する場合、 Window.Activate は App.xaml 分離コードファイルに含まれます。

コンストラクター

Window()

Window クラスの新しいインスタンスを初期化します。

プロパティ

AppWindow	この XAML に関連付けられているを `AppWindow` 取得します `Window`。
Bounds	有効 (ビュー) ピクセル単位でアプリケーションウィンドウの高さと幅を含む Rect 値を取得します。
Compositor	このウィンドウのコンポジターを取得します。
Content	アプリケーションウィンドウのビジュアルルートを取得または設定します。
CoreWindow	デスクトップアプリは常に、このプロパティに対してを返します `null` 。
Current	デスクトップアプリは常に、このプロパティに対してを返します `null` 。
Dispatcher	常に Windows アプリ SDK アプリでを返します`null`。注意 `Window.Dispatcher` は、今後のリリースで変更または使用できない可能性があります。代わりに Window.DispatcherQueue を使用してください。
DispatcherQueue	ウィンドウの `DispatcherQueue` オブジェクトを取得します。
ExtendsContentIntoTitleBar	アプリコンテンツの領域を作成するために、ウィンドウの既定のタイトルバーを非表示にするかどうかを指定する値を取得または設定します。
SystemBackdrop	この `Window`に適用するシステムの背景を取得または設定します。背景はコンテンツの背後に `Window` レンダリングされます。
Title	ウィンドウタイトルに使用される文字列を取得または設定します。
Visible	ウィンドウが表示されているかどうかを報告する値を取得します。

メソッド

Activate()	アプリケーションウィンドウをフォアグラウンドに移動し、入力フォーカスを設定して、アプリケーションウィンドウのアクティブ化を試みます。
Close()	アプリケーションウィンドウを閉じます。
SetTitleBar(UIElement)	が `true`の場合、XAML 要素に対するタイトルバーの動作を`ExtendsContentIntoTitleBar`有効にします。

イベント

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

適用対象