AttachedPropertyBrowsableForChildrenAttribute Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Indique qu’une propriété jointe possède une portée pouvant être explorée qui s’étend aux éléments enfants dans l’arborescence logique.

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

Héritage

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Attributs

AttributeUsageAttribute

Remarques

La signification du terme browsable tel qu’il est utilisé dans les descriptions de cet attribut .NET Framework est analogue aux descriptions fournies BrowsableAttributepour , mais l’étatrowsable d’une propriété jointe est particulièrement pertinent pour les informations de propriété pour extensible Application Markup Language (XAML), car une propriété jointe est principalement un concept XAML.

Lorsque cet attribut .NET Framework est appliqué à l’accesseur get pour une propriété jointe, cet attribut .NET Framework spécifie qu’une propriété jointe est extensible lorsque le propriétaire de la propriété jointe est un élément parent d’autres éléments.

Lorsqu’il est interprété par un concepteur qui utilise des informations de descripteur de type, le concepteur doit ajouter cette propriété en tant que propriété pouvant êtrerowsable à tous les éléments enfants de l’arborescence logique, en fonction de l’élément parent avec cet attribut .NET Framework appliqué.

En règle générale, la fonctionnalité parallèle de l’état pouvant êtrerowsable. Par exemple, Canvas.Left il est désigné sur les éléments qui sont des éléments enfants d’un Canvas, car Canvas inclut du code pour vérifier les valeurs définies sur Canvas.Left les éléments enfants.

Cet attribut .NET Framework prend en charge deux types de modes de détection d’arborescence pour les positions d’élément parent : un mode peu profond et un mode profond. Le mode peu profond, qui est le mode par défaut d’un attribut .NET Framework appliqué AttachedPropertyBrowsableForChildrenAttribute , nécessite que l’élément parent immédiat soit le type de propriétaire de la propriété afin que la propriété jointe soit extensible. Le mode profond est déclaré en appliquant l’attribut comme IncludeDescendants true. Le mode profond est moins restrictif, car il nécessite uniquement que le type de propriétaire soit quelque part dans la direction ancêtre de l’arborescence logique, et donc la propriété jointe estrowsable sur tous les éléments enfants, pas seulement les éléments enfants immédiats. Le mode profond est appliqué aux utilisations de propriétés jointes où l’intervention d’éléments dans l’arborescence logique ne doit pas être signalée comme l’élément parent vrai. Les collections implicites (par exemple, qui UIElementCollection sont implicites dans le Children cas d’un Panel) ne sont pas considérées comme des éléments parents à des fins de la façon dont cet attribut .NET Framework déclare le mode de détection d’arborescence.

Cet attribut .NET Framework doit uniquement être appliqué sur l’accesseur get des définitions de propriétés jointes. N’appliquez pas cet attribut .NET Framework au accesseur set. Bien qu’intuitivement, il s’agit de l’opération définie qui est rendue accessible pour XAML sur les éléments enfants, il s’agit de la présence et des caractéristiques de l’accesseur get sur l’élément parent qui contrôle le comportement réel.

Si une propriété jointe est extensible sur un élément enfant n’est pas une garantie absolue que la valeur de propriété jointe est réellement traitée par l’élément parent d’une certaine manière. En outre, la IncludeDescendants valeur n’est pas une garantie absolue que l’étendue de traitement ne s’étend pas au-delà de l’élément parent immédiat. Tout cela est spécifique à l’implémentation. Toutefois, cet attribut .NET Framework pour signaler l’état extensible est le meilleur mécanisme disponible pour signaler les informations d’utilisation et les informations fonctionnelles pour une propriété jointe. Par conséquent, vous pouvez généralement supposer que l’état extensible d’une propriété jointe est analogue au comportement de la façon dont une valeur de propriété jointe sur un élément enfant est traitée ou interprétée par l’élément parent approprié dans votre code d’application.

Pour plus d’informations sur la déclaration de propriétés jointes, consultez Vue d’ensemble des propriétés jointes.

Utilisation du texte XAML

Les membres de ce type ne sont généralement pas utilisés en XAML.

Constructeurs

AttachedPropertyBrowsableForChildrenAttribute()

Initialise une nouvelle instance de la classe AttachedPropertyBrowsableForChildrenAttribute.

Propriétés

IncludeDescendants	Obtient ou définit une valeur qui déclare s’il faut utiliser le mode profond pour la détection d’éléments parents sur la propriété jointe où cet attribut .NET Framework est appliqué.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Détermine si l’attribut .NET Framework actuel AttachedPropertyBrowsableForChildrenAttribute est égal à un objet spécifié.
GetHashCode()	Retourne le code de hachage pour cet AttachedPropertyBrowsableForChildrenAttribute attribut .NET Framework.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

Voir aussi

• System.Windows.Markup