Eventi di modifica delle proprietà
Windows Presentation Foundation (WPF) definisce diversi eventi generati in risposta a una modifica del valore di una proprietà. Spesso la proprietà è una proprietà di dipendenza. L'evento stesso è talvolta un evento indirizzato e talvolta è un evento CLR (Common Language Runtime) standard. La definizione dell'evento varia in base allo scenario, poiché alcune modifiche delle proprietà sono inviate in modo più appropriato tramite un albero di elementi, mentre altre in genere sono di interesse solo per l'oggetto in cui la proprietà è stata modificata.
Identificazione di un evento di modifica delle proprietà
Non tutti gli eventi che segnalano una modifica delle proprietà sono identificati in modo esplicito come eventi di modifica delle proprietà, per mezzo di un pattern di firma o di nome. In genere, la descrizione dell'evento nella documentazione dell'SDK indica se l'evento è direttamente associato a una modifica del valore della proprietà e fornisce riferimenti incrociati tra la proprietà e l'evento.
Eventi RoutedPropertyChanged
Alcuni eventi usano un tipo di dati di evento e un delegato che vengono usati in modo esplicito per gli eventi di modifica delle proprietà. Il tipo di dati dell'evento è RoutedPropertyChangedEventArgs<T>e il delegato è RoutedPropertyChangedEventHandler<T>. I dati di evento e il delegato dispongono entrambi di un parametro di tipo generico, usato per specificare il tipo effettivo della proprietà modificata quando si definisce il gestore. I dati dell'evento contengono due proprietà e OldValue NewValue, che vengono quindi passati entrambi come argomento di tipo nei dati dell'evento.
La parte "Routed" del nome indica che l'evento di modifica proprietà è registrato come evento indirizzato. Il vantaggio che si ottiene nell'indirizzare un evento di modifica proprietà è dato dal fatto che il livello superiore di un controllo può ricevere eventi di modifica proprietà se vengono modificati i valori delle proprietà sugli elementi figlio (parti composite del controllo). Ad esempio, è possibile creare un controllo che incorpora un RangeBase controllo, ad esempio .Slider Se il valore della Value proprietà cambia nella parte del dispositivo di scorrimento, è possibile gestire tale modifica nel controllo padre anziché nella parte.
Poiché si hanno un valore vecchio e un valore nuovo, può sembrare opportuno usare questo gestore eventi come validator per il valore della proprietà. Quest'uso, tuttavia, non rientra negli intenti di progettazione della maggior parte degli eventi di modifica proprietà. In genere i valori vengono forniti per consentire di eseguire azioni su di essi in altre aree logiche del codice, ma la modifica dei valori dall'interno del gestore eventi non è consigliabile e può causare ricorsione non intenzionale a seconda della modalità di implementazione del gestore.
Se la proprietà è una proprietà di dipendenza personalizzata o se si lavora con una classe derivata in cui è stato definito il codice di creazione di istanze, esiste un meccanismo molto migliore per tenere traccia delle modifiche delle proprietà incorporate nel sistema di proprietà WPF: i callback CoerceValueCallback di sistema delle proprietà e PropertyChangedCallback. Per altre informazioni su come usare il sistema di proprietà WPF per la convalida e la coercizione, vedere Callback e convalida delle proprietà di proprietà di dipendenza e proprietà di dipendenza personalizzate.
Eventi DependencyPropertyChanged
Un'altra coppia di tipi che fanno parte di uno scenario di evento di modifica della proprietà è DependencyPropertyChangedEventArgs e DependencyPropertyChangedEventHandler. Gli eventi per queste modifiche alle proprietà non vengono indirizzati; sono eventi CLR standard. DependencyPropertyChangedEventArgs è un tipo insolito di report dei dati degli eventi perché non deriva da EventArgs; DependencyPropertyChangedEventArgs è una struttura, non una classe.
Gli eventi che usano DependencyPropertyChangedEventArgs e DependencyPropertyChangedEventHandler sono leggermente più comuni rispetto agli RoutedPropertyChanged eventi. Un esempio di evento che usa questi tipi è IsMouseCapturedChanged.
Come RoutedPropertyChangedEventArgs<T>, DependencyPropertyChangedEventArgs segnala anche un valore precedente e nuovo per la proprietà . Inoltre, a questo evento si applicano le stesse considerazioni relative all'uso dei valori. In genere è sconsigliabile provare a modificare nuovamente i valori sul mittente in risposta all'evento.
Trigger di proprietà
Un concetto correlato strettamente a un evento di modifica proprietà è quello di trigger di proprietà. Un trigger di proprietà viene creato all'interno di uno stile o di un modello e consente di creare un comportamento condizionale basato sul valore della proprietà a cui il trigger è assegnato.
La proprietà per un trigger di proprietà deve essere una proprietà di dipendenza. Può trattarsi, come spesso accade, di una proprietà di dipendenza di sola lettura. Un buon indicatore del fatto che una proprietà di dipendenza esposta da un controllo sia progettata almeno parzialmente come trigger di proprietà è la presenza del termine "Is" nel nome della proprietà. Le proprietà con questo nome sono spesso proprietà di dipendenza booleane di sola lettura il cui scenario primario è la segnalazione dello stato di un controllo che può avere conseguenze sull'interfaccia utente in tempo reale, pertanto sono un buon candidato ad essere trigger di proprietà.
Alcune di queste proprietà hanno anche un evento di modifica proprietà dedicato. Ad esempio, la proprietà IsMouseCaptured ha un evento IsMouseCapturedChangeddi modifica della proprietà . La proprietà stessa è di sola lettura, con il relativo valore regolato dal sistema di input e il sistema di input genera IsMouseCapturedChanged ogni modifica in tempo reale.
Rispetto a un vero evento di modifica proprietà, l'uso di un trigger per gestire una modifica di proprietà presenta alcune limitazioni.
I trigger di proprietà funzionano in base a una logica di corrispondenza esatta. Specificare una proprietà e un valore che indica il valore specifico per il quale il trigger agisce. Ad esempio: <Setter Property="IsMouseCaptured" Value="true"> ... </Setter>. A causa di questa limitazione, nella maggior parte dei casi i trigger di proprietà vengono usati per proprietà booleane, o proprietà che accettano un valore di enumerazione dedicato, in cui l'intervallo di valori possibili è sufficientemente gestibile da consentire la definizione di un trigger per ogni caso. In alternativa, potrebbero esistere trigger di proprietà solo per valori speciali, ad esempio nel caso che un conteggio di elementi raggiunga lo zero, senza trigger che tengano conto dei casi in cui il valore della proprietà viene di nuovo modificato in un numero diverso da zero (anziché disporre di trigger per tutti i casi, in questo scenario potrebbe essere necessario un gestore eventi di codice o un comportamento predefinito per ripristinare lo stato del trigger quando il valore è diverso da zero).
La sintassi del trigger di proprietà è analoga a un'istruzione "if" nella programmazione. Se la condizione del trigger è true, viene eseguito il corpo del trigger di proprietà. Il corpo di un trigger di proprietà non è codice, ma markup. Tale markup è limitato all'uso di uno o più Setter elementi per impostare altre proprietà dell'oggetto in cui viene applicato lo stile o il modello.
Per compensare la condizione "if" di un trigger di proprietà con un'ampia gamma di valori possibili, è in genere consigliabile impostare lo stesso valore della proprietà su un valore predefinito usando un oggetto Setter. In questo modo, il Trigger setter contenuto avrà la precedenza quando la condizione del trigger è true e l'oggetto Setter che non si trova all'interno di un Trigger avrà la precedenza ogni volta che la condizione del trigger è false.
I trigger di proprietà sono generalmente adatti negli scenari in cui una o più proprietà di aspetto devono essere modificate, in base allo stato di un'altra proprietà sullo stesso elemento.
Per altre informazioni sui trigger di proprietà, vedere Applicazione di stili e modelli.
Vedi anche
.NET Desktop feedback