DependencyPropertyChangedEventArgs Структура

Определение

Пространство имен:

System.Windows

Сборка:

WindowsBase.dll

Предоставляет данные для различных событий изменения свойств. Обычно такие события сообщают об изменениях действительных значений в свойстве зависимостей только для чтения. Другой вариант использования — в реализации PropertyChangedCallback.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Наследование

Object

ValueType

DependencyPropertyChangedEventArgs

Примеры

В следующем примере класс используется DependencyPropertyChangedEventArgs в контексте для определенного PropertyChangedCallback свойства пользовательского класса, который также определяет события. Обратный вызов принимает результаты старых и новых значений из системы свойств, сообщаемых DependencyPropertyChangedEventArgs, и повторно упаковывает их в другой класс RoutedPropertyChangedEventArgs<T>аргументов событий . Затем новые аргументы используются в качестве данных для события ValueChanged, определенного и вызванного пользовательским классом.

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

Комментарии

События, использующие DependencyPropertyChangedEventArgs класс для данных событий, и DependencyPropertyChangedEventHandler реализации методов для обработчиков, как правило, следуют шаблону Is*Changedименования и обычно реализуются как события СРЕДЫ CLR без RoutedEvent резервного копирования (они не являются перенаправленными событиями). Некоторые методы обработки класса, которые "обрабатывают" необнаруженные события, сообщающие об изменении состояния посредством изменения свойства, например ButtonBase.OnIsPressedChanged, также используют DependencyPropertyChangedEventArgs класс для данных событий.

Сценарий для заключается в использовании аргументов для PropertyChangedCallback передачи старых и новых значений, полученных в системе свойств оценки свойства. Обратный вызов, обрабатывающий старые и новые значения, может выбрать специальную обработку в зависимости от этих значений, например не реагировать на изменения значений, которые считаются незначительными.

Конструкторы

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Инициализирует новый экземпляр класса DependencyPropertyChangedEventArgs.

Свойства

NewValue	Возвращает значение свойства после изменения.
OldValue	Возвращает значение свойства перед изменением.
Property	Возвращает идентификатор свойства зависимостей, в котором произошло изменение значения.

Методы

Equals(DependencyPropertyChangedEventArgs)	Определяет, эквивалентен ли указанный DependencyPropertyChangedEventArgs текущему DependencyPropertyChangedEventArgs.
Equals(Object)	Определяет, эквивалентен ли указанный объект текущему DependencyPropertyChangedEventArgs.
GetHashCode()	Возвращает хэш-код для данного объекта DependencyPropertyChangedEventArgs.

Операторы

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Определяет, совпадают ли значения двух указанных объектов DependencyPropertyChangedEventArgs.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Определяет, различаются ли два заданных объекта DependencyPropertyChangedEventArgs.

См. также раздел

• DependencyPropertyChangedEventHandler