CategoryAttribute Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Origem:

CategoryAttribute.cs

Especifica o nome da categoria na qual agrupar a propriedade ou evento quando exibido no controle PropertyGrid definido para o modo Categorizado.

public ref class CategoryAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

Herança

Object

Attribute

CategoryAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir cria a MyImage propriedade . A propriedade tem dois atributos: um DescriptionAttribute e um CategoryAttribute.

   [Description("The image associated with the control"),Category("Appearance")]
   System::Drawing::Image^ get()
   {
      // Insert code here.
      return m_Image1;
   }

   void set( System::Drawing::Image^ )
   {
      // Insert code here.
   }
}

[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

<Description("The image associated with the control"), _
    Category("Appearance")> _
Public Property MyImage() As Image
    
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

O próximo exemplo obtém a categoria para MyImage. Primeiro, o código obtém um PropertyDescriptorCollection com todas as propriedades do objeto . Em seguida, o código indexa no PropertyDescriptorCollection para obter MyImage. Em seguida, retorna os atributos dessa propriedade e os salva na variável attributes.

Em seguida, o exemplo imprime a categoria recuperando-a do AttributeCollectione gravando-a CategoryAttribute na tela do console.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyImage" ]->Attributes;

// Prints the description by retrieving the CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute^ myAttribute = static_cast<CategoryAttribute^>(attributes[ CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;
 
 // Prints the description by retrieving the CategoryAttribute.
 // from the AttributeCollection.
 CategoryAttribute myAttribute = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the CategoryAttribute. 
' from the AttributeCollection.
Dim myAttribute As CategoryAttribute = _
    CType(attributes(GetType(CategoryAttribute)), CategoryAttribute)
    Console.WriteLine(myAttribute.Category)

Comentários

Um CategoryAttribute indica a categoria à qual associar a propriedade ou o evento associado, ao listar propriedades ou eventos em um PropertyGrid controle definido como Categorized modo. Se um CategoryAttribute não tiver sido aplicado a uma propriedade ou evento, o o PropertyGrid associará à categoria Misc . Uma nova categoria pode ser criada para qualquer nome especificando o nome da categoria no construtor para o CategoryAttribute.

A Category propriedade indica o nome da categoria que o atributo representa. A Category propriedade também fornece localização transparente de nomes de categoria.

Notas aos Herdeiros

Se você usar nomes de categoria diferentes dos nomes predefinidos e quiser localizar seus nomes de categoria, deverá substituir o GetLocalizedString(String) método .

A CategoryAttribute classe define as seguintes categorias comuns:

Categoria	Descrição
Action	Propriedades relacionadas a ações disponíveis.
Appearance	Propriedades relacionadas à forma como uma entidade é exibida.
Behavior	Propriedades relacionadas à forma como uma entidade atua.
Data	Propriedades relacionadas ao gerenciamento de fontes de dados e dados.
Default	Propriedades agrupadas em uma categoria padrão.
Design	Propriedades disponíveis somente em tempo de design.
DragDrop	Propriedades relacionadas a operações de arrastar e soltar.
Focus	Propriedades relacionadas ao foco.
Format	Propriedades relacionadas à formatação.
Key	Propriedades relacionadas ao teclado.
Layout	Propriedades relacionadas ao layout.
Mouse	Propriedades relacionadas ao mouse.
WindowStyle	Propriedades relacionadas ao estilo de janela de formulários de nível superior.

Para obter mais informações, consulte Atributos.

Construtores

CategoryAttribute()	Inicializa uma nova instância da classe CategoryAttribute usando o nome da categoria Padrão.
CategoryAttribute(String)	Inicializa uma nova instância da classe CategoryAttribute usando o nome da categoria especificado.

Propriedades

Action	Obtém um CategoryAttribute que representa a categoria de Ação.
Appearance	Obtém um CategoryAttribute que representa a categoria de Aparência.
Asynchronous	Obtém um CategoryAttribute que representa a categoria Assíncrona.
Behavior	Obtém um CategoryAttribute que representa a categoria de Comportamento.
Category	Obtém o nome da categoria para a propriedade ou evento aos quais esse atributo é aplicado.
Data	Obtém um CategoryAttribute que representa a categoria de Dados.
Default	Obtém um CategoryAttribute que representa a categoria Padrão.
Design	Obtém um CategoryAttribute que representa a categoria de Design.
DragDrop	Obtém um CategoryAttribute que representa a categoria DragDrop.
Focus	Obtém um CategoryAttribute que representa a categoria de Foco.
Format	Obtém um CategoryAttribute que representa a categoria de Formato.
Key	Obtém um CategoryAttribute que representa a categoria de Chave.
Layout	Obtém um CategoryAttribute que representa a categoria de Layout.
Mouse	Obtém um CategoryAttribute que representa a categoria de Mouse.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)
WindowStyle	Obtém um CategoryAttribute que representa a categoria WindowStyle.

Métodos

Equals(Object)	Retorna se o valor do objeto especificado é igual ao CategoryAttribute atual.
GetHashCode()	Retorna o código hash para esse atributo.
GetLocalizedString(String)	Pesquisa o nome localizado da categoria especificada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Determina se este atributo é o padrão.
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)

Confira também

• Attribute
• PropertyDescriptor
• EventDescriptor