DependencyPropertyChangedEventHandler 代理人

  • リファレンス

定義

名前空間:
Windows.UI.Xaml
編集

特定の 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

イベントのソース (通常は、 プロパティが変更されたオブジェクト)。

e
DependencyPropertyChangedEventArgs

イベントのデータ。

属性
ContractVersionAttribute GuidAttribute

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 が必要です。 詳しくは、「カスタム依存関係プロパティ」をご覧ください。

適用対象

こちらもご覧ください