DependencyPropertyChangedEventArgs Struktur

Definisi

Ruang nama:

System.Windows

Rakitan:

WindowsBase.dll

Menyediakan data untuk berbagai peristiwa yang diubah properti. Biasanya peristiwa ini melaporkan perubahan nilai efektif dalam nilai properti dependensi baca-saja. Penggunaan lain adalah sebagai bagian PropertyChangedCallback dari implementasi.

public value class DependencyPropertyChangedEventArgs

public struct DependencyPropertyChangedEventArgs

type DependencyPropertyChangedEventArgs = struct

Public Structure DependencyPropertyChangedEventArgs

Warisan

Object

ValueType

DependencyPropertyChangedEventArgs

Contoh

Contoh berikut menggunakan DependencyPropertyChangedEventArgs kelas dalam konteks PropertyChangedCallback untuk properti tertentu dari kelas kustom yang juga menentukan peristiwa. Panggilan balik mengambil hasil nilai lama dan baru dari sistem properti seperti yang dikomunikasikan oleh DependencyPropertyChangedEventArgs, dan mengemas ulang ini ke dalam kelas RoutedPropertyChangedEventArgs<T>argumen peristiwa yang berbeda . Argumen baru kemudian digunakan sebagai data untuk peristiwa "ValueChanged" yang ditentukan oleh dan dinaikkan oleh kelas kustom.

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

Keterangan

Peristiwa yang menggunakan DependencyPropertyChangedEventArgs kelas untuk data peristiwa, dan DependencyPropertyChangedEventHandler implementasi metode untuk handler, umumnya mengikuti pola Is*Changedpenamaan , dan umumnya diimplementasikan sebagai peristiwa runtime bahasa umum (CLR) tanpa RoutedEvent mendukung (mereka bukan peristiwa yang dirutekan). Beberapa metode penanganan kelas yang "menangani" jika tidak, peristiwa yang tidak terekspos yang melaporkan perubahan status melalui perubahan properti, seperti ButtonBase.OnIsPressedChanged, juga menggunakan DependencyPropertyChangedEventArgs kelas untuk data peristiwa.

Skenario untuk PropertyChangedCallback adalah menggunakan argumen untuk melaporkan nilai lama dan baru yang berasal dari evaluasi sistem properti properti. Panggilan balik yang memproses nilai lama dan baru mungkin memilih penanganan khusus tergantung pada nilai-nilai ini, seperti memilih untuk tidak merespons perubahan nilai yang dianggap tidak signifikan.

Konstruktor

Nama	Deskripsi
DependencyPropertyChangedEventArgs(DependencyProperty, Object, Object)	Menginisialisasi instans baru dari kelas DependencyPropertyChangedEventArgs.

Properti

Nama	Deskripsi
NewValue	Mendapatkan nilai properti setelah perubahan.
OldValue	Mendapatkan nilai properti sebelum perubahan.
Property	Mendapatkan pengidentifikasi untuk properti dependensi tempat perubahan nilai terjadi.

Metode

Nama	Deskripsi
Equals(DependencyPropertyChangedEventArgs)	Menentukan apakah yang disediakan DependencyPropertyChangedEventArgs setara dengan saat ini DependencyPropertyChangedEventArgs.
Equals(Object)	Menentukan apakah objek yang disediakan setara dengan objek saat ini DependencyPropertyChangedEventArgs.
GetHashCode()	Mendapatkan kode hash untuk ini DependencyPropertyChangedEventArgs.

Operator

Nama	Deskripsi
Equality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Menentukan apakah dua objek yang ditentukan DependencyPropertyChangedEventArgs memiliki nilai yang sama.
Inequality(DependencyPropertyChangedEventArgs, DependencyPropertyChangedEventArgs)	Menentukan apakah dua objek yang ditentukan DependencyPropertyChangedEventArgs berbeda.

Lihat juga

• DependencyPropertyChangedEventHandler