AttachedPropertyBrowsableForChildrenAttribute Classe

Definizione

public ref class AttachedPropertyBrowsableForChildrenAttribute sealed : System::Windows::AttachedPropertyBrowsableAttribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false)]
public sealed class AttachedPropertyBrowsableForChildrenAttribute : System.Windows.AttachedPropertyBrowsableAttribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false)>]
type AttachedPropertyBrowsableForChildrenAttribute = class
    inherit AttachedPropertyBrowsableAttribute

Public NotInheritable Class AttachedPropertyBrowsableForChildrenAttribute
Inherits AttachedPropertyBrowsableAttribute

Ereditarietà

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Attributi

AttributeUsageAttribute

Commenti

Il significato del termine browsable usato nelle descrizioni per questo attributo .NET Framework è analogo alle descrizioni specificate per BrowsableAttribute, ma lo stato esplorabile per una proprietà associata è particolarmente rilevante per le informazioni sulle proprietà per Extensible Application Markup Language (XAML), perché una proprietà associata è principalmente un concetto XAML.

Quando questo attributo .NET Framework viene applicato alla funzione di accesso get per una proprietà associata, questo attributo .NET Framework specifica che una proprietà associata è esplorabile quando il proprietario della proprietà associata è un elemento padre di altri elementi.

Quando viene interpretato da una finestra di progettazione che usa le informazioni del descrittore di tipo, la finestra di progettazione deve aggiungere questa proprietà come proprietà esplorabile a tutti gli elementi figlio nell'albero logico, in base all'elemento padre con questo attributo .NET Framework applicato.

In genere, la funzionalità parallels dello stato esplorabile. Ad esempio, Canvas.Left è designato esplorabile sugli elementi figlio di un Canvasoggetto , perché Canvas include il codice per controllare eventuali valori set di Canvas.Left sugli elementi figlio.

Questo attributo .NET Framework supporta due tipi di modalità di rilevamento albero per le posizioni degli elementi padre: una modalità superficiale e una modalità profonda. La modalità superficiale, ovvero la modalità predefinita per un attributo .NET Framework applicato AttachedPropertyBrowsableForChildrenAttribute , richiede che l'elemento padre immediato sia il tipo proprietario della proprietà in modo che la proprietà associata sia esplorabile. La modalità profonda viene dichiarata applicando l'attributo con IncludeDescendants come true. La modalità profonda è meno restrittiva perché richiede solo che il tipo di proprietario sia da qualche parte nella direzione predecessore dell'albero logico e pertanto la proprietà associata è esplorabile su tutti gli elementi figlio, non solo gli elementi figlio immediati. La modalità profonda viene applicata per gli usi delle proprietà associate in cui gli elementi di intervento nell'albero logico non devono essere segnalati come elemento padre true. Le raccolte implicite,ad esempio, che UIElementCollection sono implicite in Children un Paneloggetto ) non vengono considerate elementi padre a scopo di come questo attributo .NET Framework dichiara la modalità di rilevamento degli alberi.

Questo attributo .NET Framework deve essere applicato solo sulla funzione di accesso get delle definizioni di proprietà associate. Non applicare questo attributo .NET Framework alla funzione di accesso set. Anche se intuitivamente è l'operazione impostata che viene resa esplorabile per XAML sugli elementi figlio, è la presenza e le caratteristiche della funzione di accesso get sull'elemento padre che controlla il comportamento vero.

Se una proprietà associata è esplorabile in un elemento figlio non è una garanzia assoluta che il valore della proprietà associata sia effettivamente elaborato dall'elemento padre in qualche modo. Inoltre, il IncludeDescendants valore non è una garanzia assoluta che l'ambito di elaborazione esegue o non si estende oltre l'elemento padre immediato. Tutto questo è specifico dell'implementazione. Tuttavia, questo attributo .NET Framework per segnalare lo stato esplorabile è il meccanismo migliore disponibile per segnalare le informazioni sull'utilizzo e le informazioni funzionali per una proprietà associata. È pertanto possibile presumere che lo stato esplorabile di una proprietà associata sia analogo al comportamento di come un valore di proprietà collegato su un elemento figlio venga elaborato o interpretato dall'elemento padre pertinente nel codice dell'applicazione.

Per informazioni generali sulla dichiarazione delle proprietà associate, vedere Panoramica delle proprietà associate.

Utilizzo del testo XAML

I membri di questo tipo non vengono in genere usati in XAML.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• System.Windows.Markup