CategoryAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.Primitives.dll

Źródło:

CategoryAttribute.cs

Określa nazwę kategorii, w której ma być grupowana właściwość lub zdarzenie, gdy jest wyświetlane w kontrolce PropertyGrid ustawionej na Tryb kategorii.

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

Dziedziczenie

Object

Attribute

CategoryAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład tworzy MyImage właściwość . Właściwość ma dwa atrybuty: a DescriptionAttribute i 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

Następny przykład pobiera kategorię dla MyImage. Najpierw kod pobiera PropertyDescriptorCollection obiekt ze wszystkimi właściwościami obiektu. Następnie kod indeksuje element , PropertyDescriptorCollection aby pobrać element MyImage. Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej attributes.

W tym przykładzie kategoria jest następnie drukowana przez pobranie CategoryAttribute z AttributeCollectionelementu i zapisanie jej na ekranie konsoli.

// 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)

Uwagi

Element CategoryAttribute wskazuje kategorię do skojarzenia skojarzonej właściwości lub zdarzenia z elementem podczas wyświetlania listy właściwości lub zdarzeń w kontrolce ustawionej PropertyGrid na Categorized tryb. Jeśli obiekt CategoryAttribute nie został zastosowany do właściwości lub zdarzenia, PropertyGrid kojarzy go z kategorią Misc . Nową kategorię można utworzyć dla dowolnej nazwy, określając nazwę kategorii w konstruktorze dla klasy CategoryAttribute.

Właściwość Category wskazuje nazwę kategorii, którą reprezentuje atrybut. Właściwość Category zapewnia również przezroczystą lokalizację nazw kategorii.

Uwagi dotyczące dziedziczenia

Jeśli używasz nazw kategorii innych niż wstępnie zdefiniowane nazwy i chcesz lokalizować nazwy kategorii, musisz zastąpić metodę GetLocalizedString(String) .

Klasa CategoryAttribute definiuje następujące typowe kategorie:

Kategoria	Opis
Action	Właściwości związane z dostępnymi akcjami.
Appearance	Właściwości związane z sposobem wyświetlania jednostki.
Behavior	Właściwości związane z działaniem jednostki.
Data	Właściwości związane z zarządzaniem danymi i źródłami danych.
Default	Właściwości pogrupowane w kategorii domyślnej.
Design	Właściwości, które są dostępne tylko w czasie projektowania.
DragDrop	Właściwości związane z operacjami przeciągania i upuszczania.
Focus	Właściwości związane z fokusem.
Format	Właściwości związane z formatowaniem.
Key	Właściwości związane z klawiaturą.
Layout	Właściwości związane z układem.
Mouse	Właściwości związane z myszą.
WindowStyle	Właściwości związane z stylem okna formularzy najwyższego poziomu.

Aby uzyskać więcej informacji, zobacz Atrybuty.

Konstruktory

CategoryAttribute()	Inicjuje CategoryAttribute nowe wystąpienie klasy przy użyciu nazwy kategorii Default.
CategoryAttribute(String)	Inicjuje CategoryAttribute nowe wystąpienie klasy przy użyciu określonej nazwy kategorii.

Właściwości

Action	Pobiera element CategoryAttribute reprezentujący kategorię Akcja.
Appearance	Pobiera element reprezentujący kategorię CategoryAttribute Wygląd.
Asynchronous	Pobiera kategorię CategoryAttribute asynchroniczną.
Behavior	Pobiera kategorię CategoryAttribute Zachowanie.
Category	Pobiera nazwę kategorii dla właściwości lub zdarzenia, do którego jest stosowany ten atrybut.
Data	Pobiera wartość reprezentującą CategoryAttribute kategorię Dane.
Default	Pobiera wartość reprezentującą kategorię CategoryAttribute Domyślna.
Design	Pobiera element reprezentujący kategorię CategoryAttribute Projekt.
DragDrop	Pobiera element reprezentujący kategorię CategoryAttribute DragDrop.
Focus	Pobiera element CategoryAttribute reprezentujący kategorię koncentracji uwagi.
Format	Pobiera element reprezentujący kategorię CategoryAttribute Format.
Key	Pobiera element reprezentujący kategorię CategoryAttribute Klucz.
Layout	Pobiera element reprezentujący kategorię CategoryAttribute Układ.
Mouse	Pobiera element CategoryAttribute reprezentujący kategorię Myszy.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)
WindowStyle	Pobiera element reprezentujący kategorię CategoryAttribute WindowStyle.

Metody

Equals(Object)	Zwraca, czy wartość danego obiektu jest równa bieżącej CategoryAttributewartości .
GetHashCode()	Zwraca kod skrótu dla tego atrybutu.
GetLocalizedString(String)	Wyszukuje zlokalizowaną nazwę określonej kategorii.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Określa, czy ten atrybut jest domyślny.
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Attribute
• PropertyDescriptor
• EventDescriptor