Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DependencyPropertyChangedEventArgs-Struktur

Stellt Daten für verschiedene Ereignisse mit Eigenschaftenänderungen bereit. Typischerweise melden diese Ereignisse effektive Änderungen des Werts einer schreibgeschützten Abhängigkeitseigenschaft. Eine weitere Verwendung ist die Verwendung im Rahmen einer PropertyChangedCallback-Implementierung.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public struct DependencyPropertyChangedEventArgs

Der DependencyPropertyChangedEventArgs-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeDependencyPropertyChangedEventArgsInitialisiert eine neue Instanz der DependencyPropertyChangedEventArgs-Klasse.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftNewValueRuft den Wert der Eigenschaft nach der Änderung ab.
Öffentliche EigenschaftOldValueRuft den Wert der Eigenschaft vor der Änderung ab.
Öffentliche EigenschaftPropertyRuft den Bezeichner für die Abhängigkeitseigenschaft ab, für die die Änderung des Werts aufgetreten ist.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEquals(DependencyPropertyChangedEventArgs)Bestimmt, ob das angegebene DependencyPropertyChangedEventArgs dem aktuellen DependencyPropertyChangedEventArgs entspricht.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt dem aktuellen DependencyPropertyChangedEventArgs entspricht. (Überschreibt ValueType.Equals(Object).)
Öffentliche MethodeGetHashCodeRuft einen Hashcode für dieses DependencyPropertyChangedEventArgs ab. (Überschreibt ValueType.GetHashCode().)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeToStringGibt den voll qualifizierten Typnamen dieser Instanz zurück. (Von ValueType geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentlicher OperatorStatischer MemberEqualityBestimmt, ob zwei angegebene DependencyPropertyChangedEventArgs-Objekte denselben Wert haben.
Öffentlicher OperatorStatischer MemberInequalityBestimmt, ob zwei angegebene DependencyPropertyChangedEventArgs-Objekte ungleich sind.
Zum Seitenanfang

Die Ereignisse, die die DependencyPropertyChangedEventArgs-Klasse für Ereignisdaten verwenden, und die Implementierungen der DependencyPropertyChangedEventHandler-Methoden für Handler folgen generell dem Benennungsmuster Is*Changed und werden immer als common language runtime (CLR)-Ereignisse ohne RoutedEvent-Sicherung implementiert (d. h., sie sind keine Routingereignisse). Einige Klassenbehandlungsmethoden, die andernfalls nicht verfügbar gemachte Ereignisse "behandeln", die eine Statusänderung durch eine Eigenschaftenänderung melden (z. B. ButtonBase.OnIsPressedChanged), verwenden auch die DependencyPropertyChangedEventArgs-Klasse für Ereignisdaten.

Das Szenario für PropertyChangedCallback besteht darin, mit den Argumenten alte und neue Werte zu melden, die aus der Eigenschaftensystemauswertung der Eigenschaft stammen. Ein Rückruf, der alte und neue Werte verarbeitet, kann eine spezielle Behandlung in Abhängigkeit von den betreffenden Werten auswählen, beispielsweise, dass nicht auf Änderungen von Werten reagiert wird, die nicht als signifikant angesehen werden.

Im folgenden Beispiel wird die DependencyPropertyChangedEventArgs-Klasse im Kontext eines PropertyChangedCallback für eine bestimmte Eigenschaft einer benutzerdefinierten Klasse verwendet, die ebenfalls Ereignisse definiert. Der Rückruf erfasst die Ergebnisse der alten und neuen Werte aus dem Eigenschaftensystem, die von DependencyPropertyChangedEventArgs übermittelt wurden und packt diese neu in eine Klasse mit anderen Ereignisargumenten, RoutedPropertyChangedEventArgs<T>. Die neuen Argumente werden anschließend als Daten für ein ValueChanged-Ereignis verwendet, das von der benutzerdefinierten Klasse definiert und ausgelöst wird.


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);
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2015 Microsoft