XamlUIPresenter 类

定义

命名空间:

Windows.UI.Xaml.Hosting

启用在 Microsoft Direct3D 图面上显示可视化树。 此类型用于设计工具托管方案，不适用于常规用途。

public ref class XamlUIPresenter sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Xaml.Hosting.HostingContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XamlUIPresenter final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Xaml.Hosting.HostingContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XamlUIPresenter

Public NotInheritable Class XamlUIPresenter

继承

Object Platform::Object IInspectable XamlUIPresenter

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows Desktop Extension SDK (在 10.0.10240.0 中引入)
API contract	Windows.UI.Xaml.Hosting.HostingContract (在 v1.0 中引入)

注解

XamlUIPresenter 不适用于常规 Microsoft DirectX 和Windows 运行时互操作方案。 不能在提交到 Microsoft Store 的 UWP 应用中使用此 API，它将无法通过认证。

有关XAML-Microsoft DirectX 互操作功能的技术，请参阅 DirectX 和 XAML 互操作。

XamlUIPresenter 专门用于与将Windows 运行时对象或其 XAML 标记表示为 Microsoft DirectX UI 中的图形对象的设计器图面进行互操作。

XamlUIPresenter 在Windows 运行时中没有构造函数。 若要获取 XamlUIPresenter 的实例，必须调用组件对象模型 (COM) 函数 (CreateXamlUIPresenter) 从Windows 运行时 DLL 导出。 例如，作为 C# 应用程序的一部分，可以导入组件对象模型 (COM) 库：

[DllImport("windows.ui.xaml.dll", SetLastError = true, CallingConvention = CallingConvention.Winapi)]
public static extern void CreateXamlUIPresenter(
    IViewObjectPresentNotifySite presentSite, out Windows.UI.Xaml.Hosting.XamlUIPresenter presenter
);

属性

CompleteTimelinesAutomatically	获取或设置一个值，该值确定主机是否希望时间线始终以结束方式运行。
RootElement	获取或设置要绘制到图面的根视觉元素。
ThemeKey	获取或设置字符串键，用于标识要从 ThemeResourcesXaml 使用的主题集。
ThemeResourcesXaml	获取或设置指定资源字典的 XAML。 资源字典包含主机应解析且应应用于内容的主题。

方法

GetFlyoutPlacement(Rect, Size, Size, Rect, FlyoutPlacementMode, Boolean, FlyoutPlacementMode)	使用显示放置目标及其浮出控件的建议大小调用 FlyoutBase 放置逻辑。 返回运行放置逻辑所得到的边界。
GetFlyoutPlacementTargetInfo(FrameworkElement, FlyoutPlacementMode, FlyoutPlacementMode, Boolean)	返回放置目标的计算边界，该目标还用于在主机中显示浮出控件。 其他 out 参数提供了有关如何计算边界的详细信息。
NotifyWindowSizeChanged()	调用 Window.Current 上的 SizeChanged 事件。 由主机用来将大小更改从主机设置传播到用户代码，以便可以将设计模式交互与运行时交互区分开来。
Present()	将图面作为主机的同步调用呈现。
Render()	呈现图面。 适用于通过计时器进行的异步调用。
SetHost(IXamlUIPresenterHost)	指定要用于应用程序资源解析的 IXamlUIPresenterHost 服务实现。
SetSize(Int32, Int32)	指定图面的宽度和高度。