DependencyPropertyChangedEventHandler 委托

定义

表示将处理在特定 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。 有关详细信息,请参阅自定义的依赖属性

适用于

另请参阅