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 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

Eigenschaften

Methoden

Operatoren

Gilt für:

Weitere Informationen

• DependencyPropertyChangedEventHandler