DependencyPropertyChangedEventArgs Estrutura

Definição

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Herança

Object

ValueType

DependencyPropertyChangedEventArgs

Exemplos

O exemplo seguinte usa a DependencyPropertyChangedEventArgs classe no contexto de a PropertyChangedCallback para uma propriedade particular de uma classe personalizada que também define eventos. O callback pega nos resultados dos valores antigos e novos do sistema de propriedades comunicados por DependencyPropertyChangedEventArgs, e reempacote-os numa classe RoutedPropertyChangedEventArgs<T>de argumentos de eventos diferente . Os novos argumentos são então usados como dados para um evento "ValueChanged" definido por e levantado pela classe personalizada.

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

Observações

Os eventos que utilizam a DependencyPropertyChangedEventArgs classe para dados de eventos, e as DependencyPropertyChangedEventHandler implementações de métodos para handlers, geralmente seguem o padrão Is*Changedde nomenclatura e são geralmente implementados como eventos de runtime de linguagem comum (CLR) sem RoutedEvent suporte (não são eventos encaminhados). Alguns métodos de tratamento de classes que "lidam" com eventos de outra forma não expostos que reportam uma alteração de estado através de uma alteração de propriedade, como ButtonBase.OnIsPressedChanged, também usam a DependencyPropertyChangedEventArgs classe para dados de eventos.

O cenário para PropertyChangedCallback é usar os argumentos para reportar valores antigos e novos que resultam da avaliação do sistema de propriedades da propriedade. Um callback que processa valores antigos e novos pode escolher um tratamento especial dependendo desses valores, como optar por não responder a alterações de valores consideradas insignificantes.

Ver também

• DependencyPropertyChangedEventHandler