AttachedPropertyBrowsableForChildrenAttribute Classe

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Specifica che una proprietà associata ha un ambito esplorabile che si estende agli elementi figlio nell'albero logico.

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

AttachedPropertyBrowsableForChildrenAttribute()

Inizializza una nuova istanza della classe AttachedPropertyBrowsableForChildrenAttribute.

Proprietà

IncludeDescendants	Ottiene o imposta un valore che dichiara se utilizzare la modalità profonda per il rilevamento degli elementi padre nella proprietà associata in cui viene applicato questo attributo .NET Framework.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Determina se l'attributo .NET Framework corrente AttachedPropertyBrowsableForChildrenAttribute è uguale a un oggetto specificato.
GetHashCode()	Restituisce il codice hash per questo AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Vedi anche

• System.Windows.Markup