DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs Struct

Определение

Предоставляет данные для различных событий изменения свойств.Provides data for various property changed events. Обычно такие события сообщают об изменениях действительных значений в свойстве зависимостей только для чтения.Typically these events report effective value changes in the value of a read-only dependency property. Также они используются как часть реализации PropertyChangedCallback.Another usage is as part of a PropertyChangedCallback implementation.

public value class DependencyPropertyChangedEventArgs
public struct DependencyPropertyChangedEventArgs
type DependencyPropertyChangedEventArgs = struct
Public Structure DependencyPropertyChangedEventArgs
Наследование
DependencyPropertyChangedEventArgsDependencyPropertyChangedEventArgsDependencyPropertyChangedEventArgsDependencyPropertyChangedEventArgs

Примеры

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

Комментарии

События, использующие DependencyPropertyChangedEventArgs класс данных события и DependencyPropertyChangedEventHandler реализации методов для обработчиков, обычно следуют шаблону именования Is*Changedи обычно реализуются как среда CLRcommon language runtime (CLR) события без RoutedEvent резервным (они не перенаправленные события).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 среда CLRcommon language runtime (CLR) events without RoutedEvent backing (they are not routed events). Какие-либо классы, методы, которые «обрабатывают». в противном случае обработка причинам события, сообщить об изменении состояния посредством изменения свойства, такие как ButtonBase.OnIsPressedChanged, также использовать DependencyPropertyChangedEventArgs класс данных события.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.

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

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

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object) DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object) DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object) DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Инициализирует новый экземпляр класса DependencyPropertyChangedEventArgs.Initializes a new instance of the DependencyPropertyChangedEventArgs class.

Свойства

NewValue NewValue NewValue NewValue

Возвращает значение свойства после изменения.Gets the value of the property after the change.

OldValue OldValue OldValue OldValue

Возвращает значение свойства перед изменением.Gets the value of the property before the change.

Property Property Property Property

Возвращает идентификатор свойства зависимостей, в котором произошло изменение значения.Gets the identifier for the dependency property where the value change occurred.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, эквивалентен ли указанный объект текущему DependencyPropertyChangedEventArgs.Determines whether the provided object is equivalent to the current DependencyPropertyChangedEventArgs.

Equals(DependencyPropertyChangedEventArgs) Equals(DependencyPropertyChangedEventArgs) Equals(DependencyPropertyChangedEventArgs) Equals(DependencyPropertyChangedEventArgs)

Определяет, эквивалентен ли указанный DependencyPropertyChangedEventArgs текущему DependencyPropertyChangedEventArgs.Determines whether the provided DependencyPropertyChangedEventArgs is equivalent to the current DependencyPropertyChangedEventArgs.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код для данного объекта DependencyPropertyChangedEventArgs.Gets a hash code for this DependencyPropertyChangedEventArgs.

Операторы

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Определяет, совпадают ли значения двух указанных объектов DependencyPropertyChangedEventArgs.Determines whether two specified DependencyPropertyChangedEventArgs objects have the same value.

Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs) Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)

Определяет, различаются ли два заданных объекта DependencyPropertyChangedEventArgs.Determines whether two specified DependencyPropertyChangedEventArgs objects are different.

Применяется к

Дополнительно