AttachedPropertyBrowsableForChildrenAttribute Classe

Définition

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

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• System.Windows.Markup