DependencyPropertyChangedEventArgs Struktur
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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*Changed
und 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. |