DependencyPropertyChangedEventArgs Struktur

Definition

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 bestimmten Eigenschaft einer benutzerdefinierten Klasse verwendet, die auch Ereignisse definiert. Der Rückruf verwendet die Ergebnisse alter und neuer Werte aus dem Eigenschaftensystem wie kommuniziert DependencyPropertyChangedEventArgs, und packt diese in eine andere Ereignisargumentklasse RoutedPropertyChangedEventArgs<T>um. 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 verwenden, und die DependencyPropertyChangedEventHandler Methodenimplementierungen für Handler folgen im Allgemeinen dem Benennungsmuster Is*Changedund werden in der Regel als CLR-Ereignisse (Common Language Runtime) ohne RoutedEvent Unterstützung implementiert (sie sind keine Routingereignisse). Einige Methoden zur Klassenbehandlung, die andernfalls nicht exponierte Ereignisse behandeln, die eine Zustandsänderung durch eine Eigenschaftsänderung melden, z ButtonBase.OnIsPressedChanged. B. die Klasse für Ereignisdaten verwenden DependencyPropertyChangedEventArgs .

Das Szenario besteht darin PropertyChangedCallback , die Argumente zu verwenden, um alte und neue Werte zu melden, die aus der Eigenschaftensystemauswertung 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 eingestuft werden.

Weitere Informationen

• DependencyPropertyChangedEventHandler