DependencyPropertyChangedEventArgs Classe

Definizione

public ref class DependencyPropertyChangedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyPropertyChangedEventArgs final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DependencyPropertyChangedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DependencyPropertyChangedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DependencyPropertyChangedEventArgs

Public NotInheritable Class DependencyPropertyChangedEventArgs

Ereditarietà

Object Platform::Object IInspectable DependencyPropertyChangedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Esempio

Questo esempio mostra un'implementazione PropertyChangedCallback che usa i dati dell'evento DependencyPropertyChangedEventArgs. In particolare, usa NewValue per impostare una proprietà correlata, che visualizza il valore numerico DependencyProperty sottostante come testo, in una parte TextBlock di un controllo composito.

private static void ValueChangedCallback(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    NumericUpDown ctl = (NumericUpDown)obj;
    Int32 newValue = (Int32)args.NewValue;

    // Update the TextElement to the new value.
    if (ctl.TextElement != null)
    {
        ctl.TextElement.Text = newValue.ToString();
    }

Private Shared Sub ValueChangedCallback(ByVal obj As DependencyObject, _
                    ByVal args As DependencyPropertyChangedEventArgs)

    Dim ctl As NumericUpDown = DirectCast(obj, NumericUpDown)
    Dim newValue As Integer = args.NewValue

    ' Update the TextElement to the new value. 
    If ctl.TextElement IsNot Nothing Then
        ctl.TextElement.Text = newValue.ToString()
    End If

Commenti

DependencyPropertyChangedEventArgs fornisce dati per due situazioni diverse che comportano modifiche ai valori delle proprietà di dipendenza:

• Informazioni di callback situazioni usate da PropertyChangedCallback per una proprietà di dipendenza personalizzata. Questo è il caso più comune.
• Dati dell'evento per un evento basato su DependencyPropertyChangedEventHandler. Questo è meno comune perché l'unico evento Windows Runtime che usa questo delegato è l'evento Control.IsEnabledChanged. Per altre info su come usare i dati dell'evento DependencyPropertyChangedEventArgs in questo caso, vedi DependencyPropertyChangedEventHandler o Control.IsEnabledChanged.

Un'implementazione PropertyChangedCallback è una parte facoltativa dei metadati della proprietà forniti quando si registra una proprietà di dipendenza. Il callback viene richiamato internamente dal sistema di proprietà di dipendenza. Per altre informazioni sulle proprietà di dipendenza in generale, vedi Panoramica delle proprietà di dipendenza personalizzate e delle proprietà di dipendenza.

In genere si definisce il metodo con accesso privato o interno. Il metodo deve essere statico. Poiché il metodo è statico, il parametro DependencyObject (d) del delegato PropertyChangedCallback è importante. Questo è ciò che identifica l'istanza specifica dell'oggetto dipendenza in cui viene modificata la proprietà. Per molte operazioni, ad esempio la correzione o la coercizione di un valore o la modifica di un altro valore della proprietà calcolata in risposta sullo stesso oggetto, si farà riferimento a questo DependencyObject. In genere si vuole eseguirne il cast al tipo di proprietario della proprietà modificata. Il tipo di proprietario è il tipo a cui fa riferimento per nome nella chiamata DependencyProperty.Register ; i metadati in cui viene assegnato propertyChangedCallback ai metadati della proprietà fanno parte della stessa chiamata.

Tenere presente la possibilità di ricorsione. Se si modifica il valore di una proprietà di dipendenza per cui viene richiamato PropertyChangedCallback , verrà richiamato di nuovo. Ad esempio, se è stato creato un callback per una proprietà Double in cui il callback ha sempre diviso il valore per 2, tale callback verrebbe chiamato in modo ricorsivo e l'app si troverebbe in un ciclo infinito.

È possibile che due o più proprietà di dipendenza diverse definiscano i callback per cambiare l'uno l'altro, ma di nuovo prestare attenzione a non creare una dipendenza circolare non intenzionale che non consenta la stabilizzazione dei valori.

PropertyChangedCallback viene richiamato solo se OldValue e NewValue nei dati dell'evento sono diversi.

OldValue e NewValue vengono non tipizzati, quindi qualsiasi confronto eseguito richiede probabilmente un cast. Molti valori delle proprietà di dipendenza usano un tipo valore, ovvero si farà affidamento sugli operatori o su altre API del tipo di valore per eseguire i confronti. Tale funzionalità è in genere disponibile nella struttura che rappresenta un valore, come API di utilità. Ad esempio, l'API dell'utilità specifica della lingua in un valore Spessore consente di confrontare i valori di Spessore .

Uso di DependencyPropertyChangedEventArgs per un evento personalizzato

Un implementatore di controllo personalizzato può prendere in considerazione l'uso di DependencyPropertyChangedEventHandler come tipo delegato se un evento personalizzato viene generato in seguito a una modifica del valore della proprietà di dipendenza. È possibile generare tale evento solo dal contesto di propertyChangedCallback. Ciò è dovuto al fatto che il valore modificato (la proprietà , il valore precedente e nuovo) deve trovarsi nelle proprietà DependencyPropertyChangedEventArgs segnalate per l'evento a livello di sistema delle proprietà. Tuttavia, non esistono costruttori per DependencyPropertyChangedEventArgs e nessuna delle relative proprietà è impostabile, quindi l'unico modo per ottenere un valore DependencyPropertyChangedEventArgs consiste nel recuperarlo dai parametri PropertyChangedCallback originali e passarlo quando si genera l'evento personalizzato.

Proprietà

Si applica a

Vedi anche

• PropertyChangedCallback
• PropertyMetadata
• DependencyObject
• DependencyProperty
• Proprietà di dipendenza personalizzate
• Panoramica delle proprietà di dipendenza