AttachedPropertyBrowsableForChildrenAttribute Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Especifica que uma propriedade anexada tem um escopo navegável que se estende aos elementos filho na árvore lógica.

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

Herança

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Atributos

AttributeUsageAttribute

Comentários

O significado do termo browsable usado nas descrições para esse atributo .NET Framework é análogo às descrições fornecidas, BrowsableAttributemas o estado sonolível de uma propriedade anexada é particularmente relevante para informações de propriedade para XAML (Extensible Application Markup Language), porque uma propriedade anexada é principalmente um conceito XAML.

Quando esse atributo .NET Framework é aplicado ao acessador get para uma propriedade anexada, esse atributo .NET Framework especifica que uma propriedade anexada é acessível quando o proprietário da propriedade anexada é um elemento pai de outros elementos.

Quando interpretado por um designer que usa informações de descritor de tipo, o designer deve adicionar essa propriedade como uma propriedade expansível a todos os elementos filho na árvore lógica, com base no elemento pai com esse atributo .NET Framework aplicado.

Geralmente, a funcionalidade de paralelos de estado sonolável. Por exemplo, Canvas.Left é designado para sobrancelhas em elementos que são elementos filho de um Canvas, porque Canvas inclui código para verificar quaisquer valores definidos em Canvas.Left elementos filho.

Esse atributo .NET Framework dá suporte a dois tipos de modos de detecção de árvore para posições de elemento pai: um modo raso e um modo profundo. O modo raso, que é o modo padrão para um atributo .NET Framework aplicado AttachedPropertyBrowsableForChildrenAttribute , requer que o elemento pai imediato seja o tipo proprietário da propriedade para que a propriedade anexada sejarowsable. O modo profundo é declarado aplicando o atributo como IncludeDescendants true. O modo profundo é menos restritivo porque requer apenas que o tipo de proprietário esteja em algum lugar na direção ancestral da árvore lógica e, portanto, a propriedade anexada é vespável em todos os elementos filho, não apenas em elementos filho imediatos. O modo profundo é aplicado para usos de propriedade anexados em que elementos intervindo na árvore lógica não devem ser relatados como o elemento pai verdadeiro. Coleções implícitas (por exemplo, as UIElementCollection implícitas em Children um Panel) não são consideradas elementos pai para fins de como esse atributo .NET Framework declara o modo de detecção de árvore.

Esse atributo .NET Framework só deve ser aplicado no acessador get de definições de propriedade anexadas. Não aplique esse atributo .NET Framework ao acessador do conjunto. Embora intuitivamente seja a operação de conjunto que está sendo tornada expansível para XAML em elementos filho, é a presença e as características do acessador get no elemento pai que controla o comportamento verdadeiro.

Se uma propriedade anexada érowsable em um elemento filho não é uma garantia absoluta de que o valor da propriedade anexada é realmente processado pelo elemento pai de alguma maneira. Além disso, o IncludeDescendants valor não é uma garantia absoluta de que o escopo de processamento se estende ou não além do elemento pai imediato. Tudo isso é específico da implementação. No entanto, esse atributo .NET Framework para relatar o estado de crescimento é o melhor mecanismo disponível para relatar as informações de uso e as informações funcionais de uma propriedade anexada. Portanto, você geralmente pode assumir que o estado de crescimento de uma propriedade anexada é análogo ao comportamento de como um valor de propriedade anexado em um elemento filho é processado ou interpretado pelo elemento pai relevante no código do aplicativo.

Para obter informações gerais sobre como declarar propriedades anexadas, consulte Visão geral de propriedades anexadas.

Uso de texto XAML

Os membros desse tipo normalmente não são usados no XAML.

Construtores

AttachedPropertyBrowsableForChildrenAttribute()

Inicializa uma nova instância da classe AttachedPropertyBrowsableForChildrenAttribute.

Propriedades

IncludeDescendants	Obtém ou define um valor que declara se deve usar o modo profundo para detecção de elementos pai na propriedade anexada em que esse atributo .NET Framework é aplicado.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Determina se o atributo .NET Framework atual AttachedPropertyBrowsableForChildrenAttribute é igual a um objeto especificado.
GetHashCode()	Retorna o código hash desse AttachedPropertyBrowsableForChildrenAttribute atributo .NET Framework.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Confira também

• System.Windows.Markup