Window 類別

定義

/// [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

範例

Onlaunch（啟動）

以下程式碼範例展示了 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;

建立新視窗

在你的應用程式中，你可以明確建立每個視窗。 建立多個視窗需要更新 Windows 應用程式 SDK 的 1.0.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();
  }
}

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

備註

欲了解更多資訊與範例，請參閱 WinUI 與 Windows 應用程式 SDK 的視窗化概覽。

通常 是Window用來將 UIElement 設定為代表應用程式 UI 的內容。 這通常是在應用程式啟用時完成的（例如在 OnLaunched 覆寫中），讓你在視窗的整個生命週期內都能更改視窗內容。

務必在初次啟用時呼叫啟用Window。 如果你使用 Microsoft Visual Studio 的預設應用程式範本，Window.Activate 會包含在App.xaml程式碼背後的檔案中。

你可以在應用程式中每個線程建立多個 Window 。 請參考 「顯示您的應用程式的多個視窗」。

Window 實作 IWindowNative ，透過視窗的 HWND（視窗Handle）實現互通。

另請參閱

• IWindowNative
• WinUI 與 Windows 應用程式 SDK 的視窗概覽
• 顯示應用程式的多個視窗
• 標題列自定義