DependencyPropertyChangedEventArgs Struktura

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Poskytuje data pro různé události změny vlastností. Tyto události obvykle hlásí změny efektivní hodnoty v hodnotě vlastnosti závislosti jen pro čtení. Další použití je součástí PropertyChangedCallback implementace.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Dědičnost

Object

ValueType

DependencyPropertyChangedEventArgs

Příklady

Následující příklad používá DependencyPropertyChangedEventArgs třídu v kontextu objektu PropertyChangedCallback pro konkrétní vlastnost vlastní třídy, která také definuje události. Zpětné volání přebírá výsledky starých a nových hodnot ze systému vlastností, jak je předává DependencyPropertyChangedEventArgs, a znovu je zabalí do jiné třídy RoutedPropertyChangedEventArgs<T>argumentů událostí . Nové argumenty se pak použijí jako data pro událost ValueChanged definovanou a vyvolanou vlastní třídou.

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

Poznámky

Události, které používají DependencyPropertyChangedEventArgs třídu pro data událostí a DependencyPropertyChangedEventHandler implementace metod pro obslužné rutiny, se obecně řídí vzorem Is*Changedpojmenování a jsou obecně implementovány jako události modulu CLR (Common Language Runtime) bez RoutedEvent zálohování (nejedná se o směrované události). Některé metody zpracování tříd, které "zpracovávají" jinak neexponované události, které hlásí změnu stavu prostřednictvím změny vlastnosti, například ButtonBase.OnIsPressedChanged, také používají DependencyPropertyChangedEventArgs třídu pro data událostí.

Scénář pro PropertyChangedCallback je použít argumenty k sestavě starých a nových hodnot, které pocházejí z vyhodnocení systému vlastností vlastnosti. Zpětné volání, které zpracovává staré a nové hodnoty, může v závislosti na těchto hodnotách zvolit zvláštní zpracování, například volbu nereagovat na změny hodnot, které jsou považovány za nevýznamné.

Konstruktory

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Inicializuje novou instanci DependencyPropertyChangedEventArgs třídy.

Vlastnosti

NewValue	Získá hodnotu vlastnosti po změně.
OldValue	Získá hodnotu vlastnosti před změnou.
Property	Získá identifikátor pro závislost vlastnost, kde došlo ke změně hodnoty.

Metody

Equals(DependencyPropertyChangedEventArgs)	Určuje, zda poskytnutá hodnota DependencyPropertyChangedEventArgs odpovídá aktuálnímu DependencyPropertyChangedEventArgs.
Equals(Object)	Určuje, zda je zadaný objekt ekvivalentní aktuálnímu DependencyPropertyChangedEventArgsobjektu .
GetHashCode()	Získá hash kód pro tento DependencyPropertyChangedEventArgs.

Operátory

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Určuje, zda dva zadané DependencyPropertyChangedEventArgs objekty mají stejnou hodnotu.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Určuje, zda se dva zadané DependencyPropertyChangedEventArgs objekty liší.

Viz také

• DependencyPropertyChangedEventHandler