DependencyPropertyChangedEventArgs Structure

Définition

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Héritage

Object

ValueType

DependencyPropertyChangedEventArgs

Exemples

L’exemple suivant utilise la DependencyPropertyChangedEventArgs classe dans le contexte d’une PropertyChangedCallback propriété particulière d’une classe personnalisée qui définit également les événements. Le rappel prend les résultats des anciennes et nouvelles valeurs du système de propriétés comme communiqué par DependencyPropertyChangedEventArgs, et les repackage dans une autre classe RoutedPropertyChangedEventArgs<T>d’arguments d’événements . Les nouveaux arguments sont ensuite utilisés comme données pour un événement « ValueChanged » défini par la classe personnalisée et déclenché par la classe personnalisée.

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

Remarques

Les événements qui utilisent la DependencyPropertyChangedEventArgs classe pour les données d’événements et les DependencyPropertyChangedEventHandler implémentations de méthode pour les gestionnaires, suivent généralement le modèle Is*Changedde nommage et sont généralement implémentés en tant qu’événements CLR (Common Language Runtime) sans RoutedEvent stockage (ils ne sont pas routés). Certaines méthodes de gestion des classes qui « gèrent » sinon des événements non exposés qui signalent une modification d’état par le biais d’une modification de propriété, par exemple ButtonBase.OnIsPressedChanged, utilisent également la DependencyPropertyChangedEventArgs classe pour les données d’événement.

Le scénario pour PropertyChangedCallback lequel utiliser les arguments pour signaler les anciennes et nouvelles valeurs provenant de l’évaluation du système de propriétés de la propriété. Un rappel qui traite les anciennes et nouvelles valeurs peut choisir une gestion spéciale en fonction de ces valeurs, telles que le choix de ne pas répondre aux modifications de valeur considérées comme insignifiantes.

Constructeurs

Propriétés

Méthodes

Opérateurs

S’applique à

Voir aussi

• DependencyPropertyChangedEventHandler