DesktopWindowXamlSource 類別

定義

命名空間:

Microsoft.UI.Xaml.Hosting

啟用桌面應用程式（例如 WPF 或 Windows Forms 應用程式）在與視窗句柄 （HWND） 相關聯的任何 UI 元素中裝載 WinUI 控制件。

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DesktopWindowXamlSource : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DesktopWindowXamlSource : System.IDisposable

Public Class DesktopWindowXamlSource
Implements IDisposable

繼承

Object IInspectable DesktopWindowXamlSource

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable

備註

DesktopWindowXamlSource 是 Windows App SDK XAML 主控 API中的主要類別。 此 API 可讓非 WASDK 傳統型應用程式裝載衍生自 Microsoft.UI.Xaml.UIElement 的任何控件， 與視窗句柄 （HWND） 相關聯的 UI 元素中。 此 API 可供使用 WPF、Windows Forms 和 Windows API （Win32） 建置的桌面應用程式使用。

如果您在建立 UIElement 物件之前，先建立 DesktopWindowXamlSource 物件，則裝載 UIElement 內容的架構可確保所有物件都初始化為相同的線程。 如果您在建立 DesktopWindowXamlSource 物件之前先建立 UIElement 物件，則必須先呼叫 Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread，才能具現化 UIElement 物件。

因為 DesktopWindowXamlSource 衍生自 IClosable，所以建議您在完成時 關閉 它（Dispose .NET 中）。

建構函式

DesktopWindowXamlSource()

初始化 DesktopWindowXamlSource 類別的新實例。

屬性

Content	取得或設定您想要在傳統型應用程式中裝載的 Microsoft.UI.Xaml.UIElement 物件。
HasFocus	取得值，指出 DesktopWindowXamlSource 目前在傳統型應用程式中是否具有焦點。
ShouldConstrainPopupsToWorkArea	取得或設定值，這個值表示具有類似快顯行為的控件是否應該限制為工作區域。
SiteBridge	取得與此 DesktopWindowXamlSource 對象相關聯的 DesktopSiteBridge。
SystemBackdrop	取得或設定用來呈現Mica和Acrylic等材質的系統背景。

方法

Close()	關閉並釋放此 DesktopWindowXamlSource所使用的任何資源。
Dispose()	執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。
Initialize(WindowId)	初始化 DesktopWindowXamlSource 類別的新實例。
NavigateFocus(XamlSourceFocusNavigationRequest)	嘗試以程式設計方式將焦點放在桌面應用程式中的 DesktopWindowXamlSource。

事件

GotFocus	發生於 DesktopWindowXamlSource 在桌面應用程式中取得焦點時（例如當使用者按下 Tab 鍵時，焦點位於 DesktopWindowXamlSource之前的專案時）。
TakeFocusRequested	發生於主桌面應用程式收到要求從 DesktopWindowXamlSource 物件中取回焦點時（例如，用戶位於 DesktopWindowXamlSource 中的最後一個可焦點元素上，然後按 Tab）。

另請參閱

• 在C++桌面 （Win32） 應用程式中使用 WinRT XAML 裝載 API