DependencyPropertyChangedEventHandler 委托
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示将处理在特定 DependencyObject 实现上更改 DependencyProperty 时发生的事件的方法。
public delegate void DependencyPropertyChangedEventHandler(Platform::Object ^ sender, DependencyPropertyChangedEventArgs ^ e);
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(153239130, 30142, 17561, 129, 128, 29, 220, 0, 84, 33, 192)]
class DependencyPropertyChangedEventHandler : MulticastDelegate
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(153239130, 30142, 17561, 129, 128, 29, 220, 0, 84, 33, 192)]
public delegate void DependencyPropertyChangedEventHandler(object sender, DependencyPropertyChangedEventArgs e);
Public Delegate Sub DependencyPropertyChangedEventHandler(sender As Object, e As DependencyPropertyChangedEventArgs)
参数
- sender
-
Object
Platform::Object
IInspectable
事件的源通常 (属性) 更改的对象。
- 属性
Windows 要求
设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
注解
DependencyPropertyChangedEventHandler 是编写 Control.IsEnabledChanged 事件的处理程序时使用的委托。 该事件是使用此委托的唯一定义Windows 运行时事件。
如果自定义事件因依赖属性值更改而触发,则自定义控件实现者可能会考虑使用 DependencyPropertyChangedEventHandler 作为委托类型。 只能从 PropertyChangedCallback 的上下文中触发此类事件。 这是因为更改的值 (属性、新旧值) 应位于在属性系统级别为事件报告的 DependencyPropertyChangedEventArgs 中。 但是, DependencyPropertyChangedEventArgs 没有任何构造函数,并且其任何属性都是可设置的,因此获取 DependencyPropertyChangedEventArgs 值的唯一方法是从原始 PropertyChangedCallback 参数获取它,并在触发自定义事件时传递它。
DependencyPropertyChangedEventHandler 不是用于自定义依赖属性元数据和自定义属性更改回调行为的委托。 为此,需要 PropertyChangedCallback。 有关详细信息,请参阅自定义的依赖属性。