PropertyPath 类

定义

命名空间:

Windows.UI.Xaml

实现一个数据结构，用于将某个属性描述为另一个属性或所属类型下的路径。 属性路径用于对象的数据绑定。

public ref class PropertyPath sealed : 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.Foundation.Metadata.Activatable(Windows.UI.Xaml.IPropertyPathFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class PropertyPath final : 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.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.IPropertyPathFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PropertyPath : DependencyObject

Public NotInheritable Class PropertyPath
Inherits DependencyObject

继承

Object Platform::Object IInspectable DependencyObject PropertyPath

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

注解

使用 PropertyPath 对象的main原因是克隆现有绑定属性并将其用于其他位置：

• 从 Binding.Path) (现有绑定获取路径。
• 使用该字符串值构造新的 PropertyPath。
• 创建新的 绑定。 将新的 PropertyPath 用于其 Binding.Path (，并且可能会过于) 调整其他一些属性。
• 使用 SetBinding 将新绑定应用到不同的对象-属性组合。

动画目标还使用属性路径概念，如 属性路径语法 主题中所述。 但是，动画目标不使用 PropertyPath 作为基础类型，它将路径表示为字符串，并使用字符串进行所有相关的 API 调用。

构造函数

PropertyPath(String)

基于路径字符串初始化 PropertyPath 类的新实例。

属性

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

方法

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
• Property-path 语法
• {Binding} 标记扩展