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í implementace PropertyChangedCallback.

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 PropertyChangedCallback konkrétní vlastnosti 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 komunikovalo 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 vlastní třídou a vyvolána 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, obecně se řídí vzorem Is*Changedpojmenování a jsou obecně implementovány jako události CLR (Common Language Runtime) bez RoutedEvent zálohování (nejsou směrovány události). Některé metody zpracování tříd, které "zpracovávají" jinak nevyexponované události, které hlásí změnu stavu prostřednictvím změny vlastnosti, například ButtonBase.OnIsPressedChanged, používají DependencyPropertyChangedEventArgs také třídu pro data událostí.

Scénářem PropertyChangedCallback je použití argumentů k hlášení starých a nových hodnot, které pocházejí ze systému vlastností vyhodnocení 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 možnost nereagovat na změny hodnot, které jsou považovány za nevýznamné.

Konstruktory

Name	Description
DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)	Inicializuje novou instanci DependencyPropertyChangedEventArgs třídy.

Vlastnosti

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

Metody

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

Operátory

Name	Description
Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Určuje, zda dva zadané DependencyPropertyChangedEventArgs objekty mají stejnou hodnotu.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Určuje, zda jsou dva zadané DependencyPropertyChangedEventArgs objekty odlišné.

Viz také

• DependencyPropertyChangedEventHandler