FrameworkTemplate 类

定义

命名空间:

Windows.UI.Xaml

创建元素的元素树。 FrameworkTemplate 是具有特定模板化行为的类的基类，包括 ControlTemplate 和 DataTemplate。

public ref class FrameworkTemplate : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Template")]
class FrameworkTemplate : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Template")]
public class FrameworkTemplate : DependencyObject

Public Class FrameworkTemplate
Inherits DependencyObject

继承

Object Platform::Object IInspectable DependencyObject FrameworkTemplate

派生

Windows.UI.Xaml.Controls.ControlTemplate

Windows.UI.Xaml.Controls.ItemsPanelTemplate

Windows.UI.Xaml.DataTemplate

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

FrameworkTemplate 具有 ContentPropertyAttribute ，指示其 XAML 内容属性名为“Template”。 FrameworkTemplate 不定义该名称的属性，也不定义其派生类型（ (ControlTemplate、 DataTemplate) 的实际用法）。 FrameworkTemplate 的内容是一个根元素，在模板应用于要模板化的对象时应创建该根元素，并且不是对象模型中的传统属性。 从模板创建内容时，XAML 分析程序专门处理 FrameworkTemplate 的内容。

有关如何使用模板的详细信息，请参阅 ControlTemplate 和 快速入门：控件模板。

FrameworkTemplate 派生类

FrameworkTemplate 是多个直接派生的类的父类，每个类定义特定的模板化行为。 下面是一些值得注意的派生类：

• ControlTemplate：它用作 Control.Template 属性的值，该属性通过应用模板定义控件的视觉对象。 几乎始终使用隐式键 TargetType 将 ControlTemplate 定义为 XAML 资源，该键与使用 Setter 设置 Control.Template 的 Style 相同。 很少会直接在控件实例上为 Control.Template 分配值。
• DataTemplate：指定数据在为项控件（如 ListView 或 GridView）提供项时数据的可视表示形式。 DataTemplate 设置项控件的 ItemTemplate 属性。 DataTemplate 还用于 ContentControl.ContentTemplate 和其他特定于控件的数据模板化属性，例如多个类上的各种 Header、 HeaderTemplate、 ContentTemplate 和 ItemTemplate 属性。
• ItemsPanelTemplate：支持一种替代方法，用于通过定义布局容器以及该容器中显示数据的部件来表示控件视觉对象中的数据。 ItemsPanelTemplate 用作 Items 控件的 ItemsControl.ItemsPanel 的值。

构造函数

FrameworkTemplate()

为 FrameworkTemplate 派生类提供基类初始化行为。

属性

Dispatcher

获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• DependencyObject
• Template
• ControlTemplate
• DataTemplate
• ItemsPanelTemplate
• 快速入门：控件模板