DependencyPropertyChangedEventArgs Struct

Definizione

Spazio dei nomi:

System.Windows

Assembly:

WindowsBase.dll

Fornisce i dati per diversi eventi di modifica delle proprietà. Questi eventi segnalano in genere effettive modifiche del valore di una proprietà di dipendenza di sola lettura. Un altro utilizzo è come parte di un'implementazione PropertyChangedCallback.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Ereditarietà

Object

ValueType

DependencyPropertyChangedEventArgs

Esempio

Nell'esempio seguente viene usata la DependencyPropertyChangedEventArgs classe nel contesto di una PropertyChangedCallback determinata proprietà di una classe personalizzata che definisce anche gli eventi. Il callback accetta i risultati dei valori precedenti e nuovi dal sistema di proprietà come comunicato da DependencyPropertyChangedEventArgse li riconfeziona in una classe RoutedPropertyChangedEventArgs<T>di argomenti eventi diversi. I nuovi argomenti vengono quindi usati come dati per un evento "ValueChanged" definito dalla classe personalizzata.

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

Commenti

Gli eventi che usano la DependencyPropertyChangedEventArgs classe per i dati degli eventi e le DependencyPropertyChangedEventHandler implementazioni del metodo per i gestori, in genere seguono il modello Is*Changeddi denominazione e vengono generalmente implementati come eventi CLR (Common Language Runtime) senza RoutedEvent eseguire il backup (non sono eventi indirizzati). Alcuni metodi di gestione delle classi che "gestiscono" in caso contrario eventi non esposti che segnalano una modifica dello stato tramite una modifica della proprietà, ad esempio ButtonBase.OnIsPressedChanged, usano anche la DependencyPropertyChangedEventArgs classe per i dati degli eventi.

Lo scenario per PropertyChangedCallback consiste nell'usare gli argomenti per segnalare valori precedenti e nuovi provenienti dalla valutazione del sistema delle proprietà della proprietà. Un callback che elabora i valori precedenti e nuovi può scegliere una gestione speciale a seconda di questi valori, ad esempio la scelta di non rispondere alle modifiche del valore considerate insignificanti.

Costruttori

DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)

Inizializza una nuova istanza della classe DependencyPropertyChangedEventArgs.

Proprietà

NewValue	Ottiene il valore della proprietà dopo la modifica.
OldValue	Ottiene il valore della proprietà prima della modifica.
Property	Ottiene l'identificatore per la proprietà di dipendenza in cui si è verificata la modifica del valore.

Metodi

Equals(DependencyPropertyChangedEventArgs)	Determina se l'oggetto DependencyPropertyChangedEventArgs specificato equivale all'oggetto DependencyPropertyChangedEventArgs corrente.
Equals(Object)	Determina se l'oggetto specificato equivale all'oggetto DependencyPropertyChangedEventArgs corrente.
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyPropertyChangedEventArgs.

Operatori

Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Determina se due oggetti DependencyPropertyChangedEventArgs specificati hanno lo stesso valore.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Determina se due oggetti DependencyPropertyChangedEventArgs specificati sono diversi.

Vedi anche

• DependencyPropertyChangedEventHandler