DependencyPropertyChangedEventArgs Struktur

Definition

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Stellt Daten für verschiedene durch geänderte Eigenschaften ausgelöste Ereignisse bereit. Diese Ereignisse melden normalerweise effektive Änderungen beim Wert einer schreibgeschützten Abhängigkeitseigenschaft. Eine weitere Verwendungsmöglichkeit ist als Teil einer PropertyChangedCallback-Implementierung.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Vererbung

Object

ValueType

DependencyPropertyChangedEventArgs

Beispiele

Im folgenden Beispiel wird die DependencyPropertyChangedEventArgs -Klasse im Kontext einer PropertyChangedCallback für eine bestimmte Eigenschaft einer benutzerdefinierten Klasse verwendet, die auch Ereignisse definiert. Der Rückruf übernimmt die Ergebnisse alter und neuer Werte aus dem Eigenschaftensystem, wie von DependencyPropertyChangedEventArgskommuniziert, und packt diese in eine andere Ereignisargumentklasse RoutedPropertyChangedEventArgs<T>. Die neuen Argumente werden dann als Daten für ein "ValueChanged"-Ereignis verwendet, das von der benutzerdefinierten Klasse definiert und ausgelöst wird.

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

Hinweise

Die Ereignisse, die die DependencyPropertyChangedEventArgs -Klasse für Ereignisdaten und die DependencyPropertyChangedEventHandler Methodenimplementierungen für Handler verwenden, folgen im Allgemeinen dem Benennungsmuster Is*Changedund werden im Allgemeinen als CLR-Ereignisse (Common Language Runtime) ohne RoutedEvent Unterstützung implementiert (es handelt sich nicht um Routingereignisse). Einige Methoden zur Klassenbehandlung, die andernfalls nicht angezeigte Ereignisse "verarbeiten", die eine Zustandsänderung über eine Eigenschaftsänderung melden, z ButtonBase.OnIsPressedChanged. B. , verwenden auch die DependencyPropertyChangedEventArgs -Klasse für Ereignisdaten.

Das Szenario für PropertyChangedCallback besteht darin, die Argumente zu verwenden, um alte und neue Werte zu melden, die aus der Eigenschaftensystembewertung der Eigenschaft stammen. Ein Rückruf, der alte und neue Werte verarbeitet, kann je nach diesen Werten eine spezielle Behandlung auswählen, z. B. die Auswahl, nicht auf Wertänderungen zu reagieren, die als unbedeutend gelten.

Konstruktoren

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Initialisiert eine neue Instanz der DependencyPropertyChangedEventArgs-Klasse.

Eigenschaften

NewValue	Ruft den Wert der Eigenschaft nach der Änderung ab.
OldValue	Ruft den Wert der Eigenschaft vor der Änderung ab.
Property	Ruft den Bezeichner für die Abhängigkeitseigenschaft ab, für die die Änderung des Werts aufgetreten ist.

Methoden

Equals(DependencyPropertyChangedEventArgs)	Bestimmt, ob das angegebene DependencyPropertyChangedEventArgs dem aktuellen DependencyPropertyChangedEventArgs entspricht.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen DependencyPropertyChangedEventArgs entspricht.
GetHashCode()	Ruft einen Hashcode für diese DependencyPropertyChangedEventArgs ab.

Operatoren

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Bestimmt, ob zwei angegebene DependencyPropertyChangedEventArgs-Objekte denselben Wert haben.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Bestimmt, ob zwei angegebene DependencyPropertyChangedEventArgs-Objekte ungleich sind.

Weitere Informationen

• DependencyPropertyChangedEventHandler