共用方式為

Microsoft.UI.Xaml.Core.Direct 命名空間

  • 參考
編輯

提供一種方式，讓中介軟體作者能夠存取低階、高效能的 XAML API，並達到更佳的 CPU 和工作集效能。

注意

此命名空間需要 Microsoft.UI.Xaml.Core.Direct NuGet 套件，這是 Microsoft Windows UI 程式庫的一部分。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

類別

XamlDirect

表示所有 XamlDirect API 的基類。 所有 XamlDirect API 都是這個類別的實例方法。

XamlDirect 是一種 API，可在更基本層級存取 Xaml，以取得更佳的 CPU 和工作集效能。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

介面

IXamlDirect

表示所有 XamlDirect API 的基類。 所有 XamlDirect API 都是這個類別的實例方法。

XamlDirect 是一種 API，可在更基本層級存取 Xaml，以取得更佳的 CPU 和工作集效能。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

列舉

XamlEventIndex

列出 XamlDirect中所有支援事件的列舉。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
XamlPropertyIndex

列出 XamlDirect中所有支援屬性的列舉。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
XamlTypeIndex

列出 XamlDirect中所有支援類型的列舉。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

範例

提示

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、特性和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支和 WinUI 2) 的 winui2 分支。

下列範例示範如何使用 XamlDirect API 將值新增至集合。

XamlDirect xd = XamlDirect.GetDefault();

IXamlDirect relativePanel = xd.CreateInstance(XamlTypeIndex.RelativePanel);

IXamlDirect childrenCollection = xd.GetXamlDirectObjectProperty(relativePanel, XamlPropertyIndex.Panel_Children);

IXamlDirect button = xd.CreateInstance(XamlTypeIndex.Button);
xd.AddToCollection(childrenCollection, button);

XamlDirect^ xd = XamlDirect::GetDefault();

IXamlDirect^ relativePanel = xd->CreateInstance(XamlTypeIndex::RelativePanel);

IXamlDirect^ childrenCollection = xd->GetXamlDirectObjectProperty(relativePanel, XamlPropertyIndex::Panel_Children);

IXamlDirect^ button = xd->CreateInstance(XamlTypeIndex::Button);
xd->AddToCollection(childrenCollection, button);

備註

XamlDirect 是專為中介軟體所建置的**- 主要使用命令式 API 來建立 UI，而不是標記。 使用 XamlDirect API，即使以命令方式在程式碼中建立 UI，您也可以與 XAML 剖析器達到效能同位。

XamlDirect API 可與傳統 API 並存使用，並利用播放效能改善的付費功能。

並非所有 Xaml API 都可搭配 XamlDirect使用。 XamlTypeIndex 列舉會列出所有支援的類型、XamlPropertyIndex 列舉會列出所有支援的屬性，而XamlEventIndex 列舉會列出所有支援的事件。

支援的函數

您可以使用 XamlDirect API 執行下列函式：

CreateInstance傳回的所有物件都是IXamlDirect類型。 所有其他 API，例如 Set*Property API，接受 IXamlDirect 作為其第一個參數。

若要將 IXamlDirect 轉換成其完整 APINDEX，例如 Button，請使用 GetObject (System.Object) 方法。 同樣地，您可以使用 GetXamlDirectObject ，從完整的 Object/DependencyObject 轉換為其 XamlDirect 對等實例。

另請參閱