DependencyPropertyChangedEventArgs Yapı

Tanım

Çeşitli özellik değiştirildi olayları için veri sağlar.Provides data for various property changed events. Genellikle bu olaylar, salt bir salt okunurdur bağımlılık özelliğinin değerindeki etkin değer değişikliklerini raporlar.Typically these events report effective value changes in the value of a read-only dependency property. Başka bir kullanım, bir uygulamanın parçası olarak kullanılır PropertyChangedCallback .Another usage is as part of a PropertyChangedCallback implementation.

public value class DependencyPropertyChangedEventArgs
public struct DependencyPropertyChangedEventArgs
type DependencyPropertyChangedEventArgs = struct
Public Structure DependencyPropertyChangedEventArgs
Devralma
DependencyPropertyChangedEventArgs

Örnekler

Aşağıdaki örnek, DependencyPropertyChangedEventArgs PropertyChangedCallback aynı zamanda olayları tanımlayan özel bir sınıfın belirli bir özelliği için bir sınıfının bağlamında sınıfını kullanır.The following example uses the DependencyPropertyChangedEventArgs class in the context of a PropertyChangedCallback for a particular property of a custom class that also defines events. Geri çağırma, eski ve yeni değerlerin sonuçlarını, tarafından iletilen Özellik sisteminden alır DependencyPropertyChangedEventArgs ve bunları farklı olaylar bağımsız değişkenleri sınıfına yeniden paketler RoutedPropertyChangedEventArgs<T> .The callback takes the results of old and new values from the property system as communicated by DependencyPropertyChangedEventArgs, and repackages these into a different events arguments class RoutedPropertyChangedEventArgs<T>. Yeni bağımsız değişkenler daha sonra tarafından tanımlanan ve özel sınıf tarafından oluşturulan bir "ValueChanged" olayının verileri olarak kullanılır.The new arguments are then used as the data for a "ValueChanged" event defined by and raised by the custom class.

public static readonly DependencyProperty ValueProperty =
    DependencyProperty.Register(
        "Value", typeof(decimal), typeof(NumericUpDown),
        new FrameworkPropertyMetadata(MinValue, new PropertyChangedCallback(OnValueChanged),
                                      new CoerceValueCallback(CoerceValue)));

private static object CoerceValue(DependencyObject element, object value)
{
    decimal newValue = (decimal)value;

    newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue));

    return newValue;
}

private static void OnValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    NumericUpDown control = (NumericUpDown)obj;

    RoutedPropertyChangedEventArgs<decimal> e = new RoutedPropertyChangedEventArgs<decimal>(
        (decimal)args.OldValue, (decimal)args.NewValue, ValueChangedEvent);
    control.OnValueChanged(e);
}
/// <summary>
/// Identifies the ValueChanged routed event.
/// </summary>
public static readonly RoutedEvent ValueChangedEvent = EventManager.RegisterRoutedEvent(
    "ValueChanged", RoutingStrategy.Bubble,
    typeof(RoutedPropertyChangedEventHandler<decimal>), typeof(NumericUpDown));

/// <summary>
/// Occurs when the Value property changes.
/// </summary>
public event RoutedPropertyChangedEventHandler<decimal> ValueChanged
{
    add { AddHandler(ValueChangedEvent, value); }
    remove { RemoveHandler(ValueChangedEvent, value); }
}
/// <summary>
/// Raises the ValueChanged event.
/// </summary>
/// <param name="args">Arguments associated with the ValueChanged event.</param>
protected virtual void OnValueChanged(RoutedPropertyChangedEventArgs<decimal> args)
{
    RaiseEvent(args);
}
Public Shared ReadOnly ValueProperty As DependencyProperty = DependencyProperty.Register("Value", GetType(Decimal), GetType(NumericUpDown), New FrameworkPropertyMetadata(MinValue, New PropertyChangedCallback(AddressOf OnValueChanged), New CoerceValueCallback(AddressOf CoerceValue)))

Private Shared Overloads Function CoerceValue(ByVal element As DependencyObject, ByVal value As Object) As Object
    Dim newValue As Decimal = CDec(value)

    newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue))

    Return newValue
End Function

Private Shared Sub OnValueChanged(ByVal obj As DependencyObject, ByVal args As DependencyPropertyChangedEventArgs)
    Dim control As NumericUpDown = CType(obj, NumericUpDown)

    Dim e As New RoutedPropertyChangedEventArgs(Of Decimal)(CDec(args.OldValue), CDec(args.NewValue), ValueChangedEvent)
    control.OnValueChanged(e)
End Sub
''' <summary>
''' Identifies the ValueChanged routed event.
''' </summary>
Public Shared ReadOnly ValueChangedEvent As RoutedEvent = EventManager.RegisterRoutedEvent("ValueChanged", RoutingStrategy.Bubble, GetType(RoutedPropertyChangedEventHandler(Of Decimal)), GetType(NumericUpDown))

''' <summary>
''' Occurs when the Value property changes.
''' </summary>
Public Custom Event ValueChanged As RoutedPropertyChangedEventHandler(Of Decimal)
    AddHandler(ByVal value As RoutedPropertyChangedEventHandler(Of Decimal))
        MyBase.AddHandler(ValueChangedEvent, value)
    End AddHandler
    RemoveHandler(ByVal value As RoutedPropertyChangedEventHandler(Of Decimal))
        MyBase.RemoveHandler(ValueChangedEvent, value)
    End RemoveHandler
    RaiseEvent(ByVal sender As System.Object, ByVal e As RoutedPropertyChangedEventArgs(Of Decimal))
    End RaiseEvent
End Event
''' <summary>
''' Raises the ValueChanged event.
''' </summary>
''' <param name="args">Arguments associated with the ValueChanged event.</param>
Protected Overridable Sub OnValueChanged(ByVal args As RoutedPropertyChangedEventArgs(Of Decimal))
    MyBase.RaiseEvent(args)
End Sub

Açıklamalar

DependencyPropertyChangedEventArgsOlay verileri için sınıfını kullanan olaylar ve DependencyPropertyChangedEventHandler işleyiciler için yöntem uygulamaları, genellikle adlandırma modelini izler Is*Changed ve genellikle ortak dil çalışma zamanı (CLR)common language runtime (CLR) yedekleme olmayan olaylar olarak uygulanır RoutedEvent (yönlendirilmeyen olaylar değildir).The events that use the DependencyPropertyChangedEventArgs class for event data, and the DependencyPropertyChangedEventHandler method implementations for handlers, generally follow the naming pattern Is*Changed, and are generally implemented as ortak dil çalışma zamanı (CLR)common language runtime (CLR) events without RoutedEvent backing (they are not routed events). Bazı sınıf işleme yöntemleri, bir durum değişikliğini rapor eden bir özellik değişikliği aracılığıyla rapor eden "tanıtıcı", aksi takdirde ButtonBase.OnIsPressedChanged DependencyPropertyChangedEventArgs Olay verileri için sınıfını kullanır.Some class handling methods that "handle" otherwise unexposed events that report a state change through a property change, such as ButtonBase.OnIsPressedChanged, also use the DependencyPropertyChangedEventArgs class for event data.

İçin senaryosu, PropertyChangedCallback özelliğin özellik sistem değerlendirmesinden gelen eski ve yeni değerleri raporlamak için bağımsız değişkenleri kullanmaktır.The scenario for PropertyChangedCallback is to use the arguments to report old and new values that come from the property system evaluation of the property. Eski ve yeni değerleri işleyen bir geri çağırma işlemi, bu değerlere bağlı olarak, önemli olan değer değişikliklerine yanıt vermeyi seçme gibi özel işleme seçebilirler.A callback that processes old and new values might choose special handling depending on these values, such as choosing to not respond to value changes that are deemed insignificant.

Oluşturucular

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

DependencyPropertyChangedEventArgs sınıfının yeni bir örneğini başlatır.Initializes a new instance of the DependencyPropertyChangedEventArgs class.

Özellikler

NewValue

Değişiklikten sonra özelliğin değerini alır.Gets the value of the property after the change.

OldValue

Değişiklikten önceki özelliğin değerini alır.Gets the value of the property before the change.

Property

Değer değişikliğinin gerçekleştiği bağımlılık özelliği için tanımlayıcıyı alır.Gets the identifier for the dependency property where the value change occurred.

Yöntemler

Equals(DependencyPropertyChangedEventArgs)

Belirtilen değerin geçerli olup olmadığını belirler DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs .Determines whether the provided DependencyPropertyChangedEventArgs is equivalent to the current DependencyPropertyChangedEventArgs.

Equals(Object)

Belirtilen nesnenin geçerli ile eşdeğer olup olmadığını belirler DependencyPropertyChangedEventArgs .Determines whether the provided object is equivalent to the current DependencyPropertyChangedEventArgs.

GetHashCode()

Bunun için bir karma kodu alır DependencyPropertyChangedEventArgs .Gets a hash code for this DependencyPropertyChangedEventArgs.

İşleçler

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Belirtilen iki DependencyPropertyChangedEventArgs nesnenin aynı değere sahip olup olmadığını belirler.Determines whether two specified DependencyPropertyChangedEventArgs objects have the same value.

Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Belirtilen iki nesnenin farklı olup olmadığını belirler DependencyPropertyChangedEventArgs .Determines whether two specified DependencyPropertyChangedEventArgs objects are different.

Şunlara uygulanır

Ayrıca bkz.