DependencyPropertyChangedEventArgs Yapı

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Çeşitli özellik değişikliği olayları için veri sağlar. Bu olaylar genellikle salt okunur bağımlılık özelliğinin değerindeki etkin değer değişikliklerini bildirir. Başka bir kullanım, PropertyChangedCallback uygulamasının bir parçasıdır.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Devralma

Object

ValueType

DependencyPropertyChangedEventArgs

Örnekler

Aşağıdaki örnek, olayları da tanımlayan özel bir DependencyPropertyChangedEventArgs sınıfın belirli bir özelliği için bağlamında sınıfını kullanırPropertyChangedCallback. Geri çağırma, tarafından DependencyPropertyChangedEventArgsiletildikçe özellik sisteminden eski ve yeni değerlerin sonuçlarını alır ve bunları farklı bir olay bağımsız değişkenleri sınıfına RoutedPropertyChangedEventArgs<T>yeniden paketler. Yeni bağımsız değişkenler daha sonra tarafından tanımlanan ve özel sınıf tarafından tetiklenen "ValueChanged" olayının verileri olarak kullanılır.

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

Olay verileri için sınıfını DependencyPropertyChangedEventArgs kullanan olaylar ve DependencyPropertyChangedEventHandler işleyiciler için yöntem uygulamaları genellikle adlandırma desenini Is*Changedizler ve genellikle desteklenmeden RoutedEvent ortak dil çalışma zamanı (CLR) olayları olarak uygulanır (yönlendirilen olaylar değildir). Gibi ButtonBase.OnIsPressedChangedbir özellik değişikliği aracılığıyla bir durum değişikliğini bildiren aksi halde kullanıma sunulmamış olayları "işleyen" bazı sınıf işleme yöntemleri de olay verileri için sınıfını kullanır DependencyPropertyChangedEventArgs .

için senaryo, özelliğin özellik sistemi değerlendirmesinden gelen eski ve yeni değerleri raporlamak için PropertyChangedCallback bağımsız değişkenleri kullanmaktır. Eski ve yeni değerleri işleyen bir geri çağırma, bu değerlere bağlı olarak, önemsiz olarak kabul edilen değer değişikliklerine yanıt vermemeyi seçme gibi özel işlemeyi seçebilir.

Oluşturucular

Name	Description
DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)	DependencyPropertyChangedEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
NewValue	Değişiklik sonrasında özelliğinin değerini alır.
OldValue	Değişiklik öncesinde özelliğinin değerini alır.
Property	Değer değişikliğinin gerçekleştiği bağımlılık özelliğinin tanımlayıcısını alır.

Yöntemler

Name	Description
Equals(DependencyPropertyChangedEventArgs)	Sağlanan DependencyPropertyChangedEventArgs öğesinin geçerli DependencyPropertyChangedEventArgsile eşdeğer olup olmadığını belirler.
Equals(Object)	Sağlanan nesnenin geçerli DependencyPropertyChangedEventArgsile eşdeğer olup olmadığını belirler.
GetHashCode()	Bu DependencyPropertyChangedEventArgsiçin bir karma kodu alır.

İşleçler

Name	Description
Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Belirtilen DependencyPropertyChangedEventArgs iki nesnenin aynı değere sahip olup olmadığını belirler.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Belirtilen DependencyPropertyChangedEventArgs iki nesnenin farklı olup olmadığını belirler.

Ayrıca bkz.

• DependencyPropertyChangedEventHandler