AttachedPropertyBrowsableForChildrenAttribute Classe

Definizione

Specifica che una proprietà associata ha un ambito esplorabile che si estende agli elementi figlio nell'albero logico.Specifies that an attached property has a browsable scope that extends to child elements in the logical tree.

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à
AttachedPropertyBrowsableForChildrenAttribute
Attributi

Commenti

Il significato del termine browsable usato nelle descrizioni per questo attributo .NET Framework.NET Framework attribute è analogo alle descrizioni fornite per BrowsableAttribute , ma lo stato esplorabile di una proprietà associata è particolarmente rilevante per le informazioni sulle proprietà per Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) , perché una proprietà associata è principalmente un XAMLXAML concetto.The meaning of the term browsable as used in descriptions for this attributo .NET Framework.NET Framework attribute is analogous to the descriptions given for BrowsableAttribute, but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), because an attached property is primarily a XAMLXAML concept.

Quando attributo .NET Framework.NET Framework attribute viene applicato alla funzione di accesso get per una proprietà associata, attributo .NET Framework.NET Framework attribute specifica che una proprietà associata è esplorabile quando il proprietario della proprietà associata è un elemento padre di altri elementi.When this attributo .NET Framework.NET Framework attribute is applied to the get accessor for an attached property, this attributo .NET Framework.NET Framework attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements.

Quando viene interpretato da una finestra di progettazione che utilizza informazioni sul 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 attributo .NET Framework.NET Framework attribute applicato.When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this attributo .NET Framework.NET Framework attribute applied.

In generale, lo stato esplorabile è parallelo alla funzionalità.Generally, the browsable state parallels functionality. Ad esempio, Canvas.Left è designato come esplorabile su elementi che sono elementi figlio di un oggetto Canvas , perché Canvas include il codice per il controllo di tutti i valori impostati di Canvas.Left sugli elementi figlio.For example, Canvas.Left is designated browsable on elements that are child elements of a Canvas, because Canvas includes code for checking any set values of Canvas.Left on child elements.

attributo .NET Framework.NET Framework attributeSupporta due tipi di modalità di rilevamento albero per le posizioni degli elementi padre: una modalità superficiale e una modalità approfondita.This attributo .NET Framework.NET Framework attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. Per la modalità superficiale, che è la modalità predefinita per un oggetto applicato AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute , è necessario che l'elemento padre immediato sia il tipo di proprietario della proprietà, in modo che la proprietà associata sia esplorabile.The shallow mode, which is the default mode for an applied AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. La modalità Deep viene dichiarata applicando l'attributo con IncludeDescendants come true .The deep mode is declared by applying the attribute with IncludeDescendants as true. La modalità approfondita è meno restrittiva perché richiede solo che il tipo di proprietario si trovi in un punto della direzione predecessore dell'albero logico, quindi la proprietà associata è esplorabile su tutti gli elementi figlio, non solo sugli elementi figlio immediati.The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. La modalità Deep viene applicata per gli utilizzi delle proprietà associate, in cui gli elementi che interessano nell'albero logico non devono essere segnalati come elemento padre true.The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. Le raccolte implicite (ad esempio, UIElementCollection implicite in Children di a Panel ) non sono considerate elementi padre per il modo in cui viene attributo .NET Framework.NET Framework attribute dichiarata la modalità di rilevamento dell'albero.Implicit collections (for example, the UIElementCollection that is implicit in the Children of a Panel) are not considered to be parent elements for purposes of how this attributo .NET Framework.NET Framework attribute declares the tree detection mode.

Questa operazione attributo .NET Framework.NET Framework attribute deve essere applicata solo alla funzione di accesso get delle definizioni di proprietà associate.This attributo .NET Framework.NET Framework attribute should only be applied on the get accessor of attached property definitions. Non applicare questo attributo .NET Framework.NET Framework attribute oggetto alla funzione di accesso set.Do not apply this attributo .NET Framework.NET Framework attribute to the set accessor. Sebbene sia intuitivamente l'operazione di impostazione che viene resa esplorabile per XAMLXAML gli elementi figlio, è la presenza e le caratteristiche della funzione di accesso get sull'elemento padre che controlla il comportamento effettivo.Although intuitively it is the set operation that is being made browsable for XAMLXAML on child elements, it is the presence and characteristics of the get accessor on the parent element that controls the true behavior.

Se una proprietà associata è esplorabile su un elemento figlio non è una garanzia assoluta che il valore della proprietà associata venga effettivamente elaborato dall'elemento padre in qualche modo.Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. Inoltre, il IncludeDescendants valore non è una garanzia assoluta che l'ambito di elaborazione non si estenda oltre l'elemento padre immediato.Also, the IncludeDescendants value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. Si tratta di un'implementazione specifica.All this is implementation specific. Tuttavia, questo attributo .NET Framework.NET Framework attribute per segnalare lo stato esplorabile è il miglior meccanismo disponibile per la segnalazione delle informazioni sull'utilizzo e delle informazioni funzionali per una proprietà associata.However, this attributo .NET Framework.NET Framework attribute for reporting the browsable state is the best available mechanism for reporting the usage information and functional information for an attached property. Pertanto, in genere è possibile presupporre che lo stato esplorabile di una proprietà associata sia analogo al comportamento del modo in cui un valore della proprietà associata su un elemento figlio viene elaborato o interpretato dall'elemento padre pertinente nel codice dell'applicazione.Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code.

Per informazioni generali sulla dichiarazione delle proprietà associate, vedere Cenni preliminari sulle proprietà associate.For general information on declaring attached properties, see Attached Properties Overview.

Utilizzo del testo XAMLXAML Text Usage

I membri di questo tipo non vengono in genere utilizzati in XAMLXAML .Members of this type are not typically used in XAMLXAML.

Costruttori

AttachedPropertyBrowsableForChildrenAttribute()

Inizializza una nuova istanza della classe AttachedPropertyBrowsableForChildrenAttribute.Initializes a new instance of the AttachedPropertyBrowsableForChildrenAttribute class.

Proprietà

IncludeDescendants

Ottiene o imposta un valore che dichiara se usare la modalità completa per il rilevamento di elementi padre della proprietà associata in cui si applica attributo .NET Framework.NET Framework attribute.Gets or sets a value that declares whether to use the deep mode for detection of parent elements on the attached property where this attributo .NET Framework.NET Framework attribute is applied.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Determina se l' AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute oggetto corrente è uguale a un oggetto specificato.Determines whether the current AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute is equal to a specified object.

GetHashCode()

Restituisce il codice hash per questo oggetto AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute.Returns the hash code for this AttachedPropertyBrowsableForChildrenAttribute attributo .NET Framework.NET Framework attribute.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Maps a set of names to a corresponding set of dispatch identifiers.

(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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a

Vedi anche