DependencyPropertyChangedCallback 代理人

定義

public delegate void DependencyPropertyChangedCallback(DependencyObject ^ sender, DependencyProperty ^ dp);

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1166556438, 10175, 19393, 172, 38, 148, 193, 96, 31, 58, 73)]
class DependencyPropertyChangedCallback : MulticastDelegate

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1166556438, 10175, 19393, 172, 38, 148, 193, 96, 31, 58, 73)]
public delegate void DependencyPropertyChangedCallback(DependencyObject sender, DependencyProperty dp);

Public Delegate Sub DependencyPropertyChangedCallback(sender As DependencyObject, dp As DependencyProperty)

パラメーター

属性

ContractVersionAttribute GuidAttribute

Windows の要件

例

この例では、DependencyPropertyChangedCallback デリゲートを使用して、TextBlock の Tag プロパティの変更をリッスンする方法を示します。

<TextBlock x:Name="textBlock1" Text="Hello, world"/>

long tagToken;
protected override void OnNavigatedTo(NavigationEventArgs e)
{
    long tagToken = textBlock1.RegisterPropertyChangedCallback(TextBlock.TagProperty, tbTagChangedCallback);
    base.OnNavigatedTo(e);

    textBlock1.Tag = "name";
}

protected override void OnNavigatedFrom(NavigationEventArgs e)
{
    textBlock1.UnregisterPropertyChangedCallback(TextBlock.TagProperty, tagToken);
    base.OnNavigatedFrom(e);
}

private void tbTagChangedCallback(DependencyObject sender, DependencyProperty dp)
{
    if (dp == TextBlock.TagProperty)
    {
       // These lines produce the same result.
       System.Diagnostics.Debug.WriteLine("The tag has been set to " + ((TextBlock)sender).Tag);
       System.Diagnostics.Debug.WriteLine("The tag has been set to " + sender.GetValue(dp));
    }
}

注釈

デリゲートのパラメーター値は、プロパティ変更通知の特定のプロパティを登録 した RegisterPropertyChangedCallback 呼び出しに指定されたパラメーターと、それを呼び出したインスタンスに基づいています。

コールバックには、変更されたプロパティ値を識別する dp パラメーターがあるため、同じコールバックを使用して複数のプロパティ変更ケースを処理できます。また、ロジックでは、異なるプロパティごとにケースを記述できます。

パフォーマンス上の理由から、DependencyPropertyChangedEventArgs の場合と同様に、PropertyChangedCallback メソッドから OldValue / NewValue プロパティ ペアを取得することはできません。 プロパティ値はコールバックの前に変更されるため、メソッドが呼び出されたら、 DependencyObject.GetValue を呼び出して新しい値を取得できます。

適用対象

こちらもご覧ください

• RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)
• UnregisterPropertyChangedCallback(DependencyProperty, Int64)