Partilhar via


DependencyPropertyChangedEventArgs Estrutura

Definição

Fornece dados para vários eventos alterados pela propriedade. Normalmente, esses eventos relatam alterações de valor efetivo no valor de uma propriedade de dependência somente leitura. Outro uso é como parte de uma implementação PropertyChangedCallback.

public value class DependencyPropertyChangedEventArgs
public struct DependencyPropertyChangedEventArgs
type DependencyPropertyChangedEventArgs = struct
Public Structure DependencyPropertyChangedEventArgs
Herança
DependencyPropertyChangedEventArgs

Exemplos

O exemplo a seguir usa a DependencyPropertyChangedEventArgs classe no contexto de uma PropertyChangedCallback propriedade específica de uma classe personalizada que também define eventos. O retorno de chamada usa os resultados de valores antigos e novos do sistema de propriedades conforme comunicado e DependencyPropertyChangedEventArgsos reempacota em uma classe RoutedPropertyChangedEventArgs<T>de argumentos de eventos diferentes. Os novos argumentos são usados como dados para um evento "ValueChanged" definido e gerados 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

Comentários

Os eventos que usam a DependencyPropertyChangedEventArgs classe para dados de evento e as DependencyPropertyChangedEventHandler implementações de método para manipuladores geralmente seguem o padrão Is*Changedde nomenclatura e geralmente são implementados como eventos CLR (Common Language Runtime) sem RoutedEvent suporte (não são eventos roteados). Alguns métodos de tratamento de classe que "manipulam" de outra forma eventos não expostos que relatam uma alteração de estado por meio de uma alteração de propriedade, como ButtonBase.OnIsPressedChanged, também usam a DependencyPropertyChangedEventArgs classe para dados de evento.

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

Construtores

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Inicializa uma nova instância da classe DependencyPropertyChangedEventArgs.

Propriedades

NewValue

Obtém o valor da propriedade depois da alteração.

OldValue

Obtém o valor da propriedade antes da alteração.

Property

Obtém o identificador para a propriedade de dependência em que ocorreu a alteração de valor.

Métodos

Equals(DependencyPropertyChangedEventArgs)

Determina se o DependencyPropertyChangedEventArgs fornecido é equivalente ao DependencyPropertyChangedEventArgs atual.

Equals(Object)

Determina se o objeto fornecido é equivalente ao DependencyPropertyChangedEventArgs atual.

GetHashCode()

Obtém o código hash para esse DependencyPropertyChangedEventArgs.

Operadores

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Determina se dois objetos DependencyPropertyChangedEventArgs especificados têm o mesmo valor.

Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Determina se dois objetos DependencyPropertyChangedEventArgs especificados são diferentes.

Aplica-se a

Confira também