DependencyPropertyChangedEventArgs Struktura

Definicja

Udostępnia dane dla różnych zdarzeń ze zmienionymi właściwościami.Provides data for various property changed events. Zwykle te zdarzenia raportują czynne zmiany wartości w wartości właściwości zależności tylko do odczytu.Typically these events report effective value changes in the value of a read-only dependency property. Inne użycie jest częścią PropertyChangedCallback implementacji.Another usage is as part of a PropertyChangedCallback implementation.

public value class DependencyPropertyChangedEventArgs
public struct DependencyPropertyChangedEventArgs
type DependencyPropertyChangedEventArgs = struct
Public Structure DependencyPropertyChangedEventArgs
Dziedziczenie
DependencyPropertyChangedEventArgs

Przykłady

Poniższy przykład używa DependencyPropertyChangedEventArgs klasy w kontekście PropertyChangedCallback dla określonej właściwości klasy niestandardowej, która również definiuje zdarzenia.The following example uses the DependencyPropertyChangedEventArgs class in the context of a PropertyChangedCallback for a particular property of a custom class that also defines events. Wywołanie zwrotne pobiera wyniki starych i nowych wartości z systemu właściwości jako przekazane przez DependencyPropertyChangedEventArgsi ponownie pakuje je do innej klasy RoutedPropertyChangedEventArgs<T>argumentów zdarzeń.The callback takes the results of old and new values from the property system as communicated by DependencyPropertyChangedEventArgs, and repackages these into a different events arguments class RoutedPropertyChangedEventArgs<T>. Nowe argumenty są następnie używane jako dane dla zdarzenia "ValueChanged" zdefiniowanego przez i wywołanego przez klasę niestandardową.The new arguments are then used as the data for a "ValueChanged" event defined by and raised by the custom class.

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

Uwagi

Zdarzenia, które używają DependencyPropertyChangedEventArgs klasy dla danych zdarzeń DependencyPropertyChangedEventHandler oraz implementacje metod dla programów obsługi, zazwyczaj stosują się do wzorca Is*Changednazewnictwa i są zwykle zaimplementowane jako środowisko uruchomieniowe języka wspólnego (CLR)common language runtime (CLR) zdarzenia bez RoutedEvent Tworzenie kopii zapasowych (nie są to zdarzenia kierowane).The events that use the DependencyPropertyChangedEventArgs class for event data, and the DependencyPropertyChangedEventHandler method implementations for handlers, generally follow the naming pattern Is*Changed, and are generally implemented as środowisko uruchomieniowe języka wspólnego (CLR)common language runtime (CLR) events without RoutedEvent backing (they are not routed events). Niektóre metody obsługujące klasy obsługujące w przeciwnym razie nieuwidocznione zdarzenia, które zgłaszają zmianę stanu za pomocą zmiany właściwości ButtonBase.OnIsPressedChanged, takie jak, DependencyPropertyChangedEventArgs również używają klasy dla danych zdarzenia.Some class handling methods that "handle" otherwise unexposed events that report a state change through a property change, such as ButtonBase.OnIsPressedChanged, also use the DependencyPropertyChangedEventArgs class for event data.

Scenariusz dla programu PropertyChangedCallback polega na użyciu argumentów do raportowania starych i nowych wartości, które pochodzą z oceny systemu właściwości.The scenario for PropertyChangedCallback is to use the arguments to report old and new values that come from the property system evaluation of the property. Wywołanie zwrotne, które przetwarza stare i nowe wartości, może wybrać specjalną obsługę w zależności od tych wartości, takich jak rezygnacja z odpowiedzi na zmiany wartości, które są uznawane za nieistotne.A callback that processes old and new values might choose special handling depending on these values, such as choosing to not respond to value changes that are deemed insignificant.

Konstruktory

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Inicjuje nowe wystąpienie klasy DependencyPropertyChangedEventArgs klasy.Initializes a new instance of the DependencyPropertyChangedEventArgs class.

Właściwości

NewValue

Pobiera wartość właściwości po zmianie.Gets the value of the property after the change.

OldValue

Pobiera wartość właściwości przed zmianą.Gets the value of the property before the change.

Property

Pobiera identyfikator właściwości zależności, w której wystąpiła zmiana wartości.Gets the identifier for the dependency property where the value change occurred.

Metody

Equals(DependencyPropertyChangedEventArgs)

Określa, czy podana DependencyPropertyChangedEventArgs jest równoważna z bieżącym DependencyPropertyChangedEventArgs.Determines whether the provided DependencyPropertyChangedEventArgs is equivalent to the current DependencyPropertyChangedEventArgs.

Equals(Object)

Określa, czy podany obiekt jest równoważny z bieżącym DependencyPropertyChangedEventArgs.Determines whether the provided object is equivalent to the current DependencyPropertyChangedEventArgs.

GetHashCode()

Pobiera kod skrótu dla tego DependencyPropertyChangedEventArgselementu.Gets a hash code for this DependencyPropertyChangedEventArgs.

Operatory

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Określa, czy dwa DependencyPropertyChangedEventArgs określone obiekty mają tę samą wartość.Determines whether two specified DependencyPropertyChangedEventArgs objects have the same value.

Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Określa, czy dwa DependencyPropertyChangedEventArgs określone obiekty są różne.Determines whether two specified DependencyPropertyChangedEventArgs objects are different.

Dotyczy

Zobacz też