CategoryAttribute Třída

Definice

public ref class CategoryAttribute : Attribute

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

public class CategoryAttribute : Attribute

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

type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

Dědičnost

Object

Attribute

CategoryAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad vytvoří MyImage vlastnost . Vlastnost má dva atributy: a DescriptionAttribute a 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

Další příklad získá kategorii pro MyImage. Kód nejprve získá se PropertyDescriptorCollection všemi vlastnostmi objektu . Dále se kód indexuje do objektu , PropertyDescriptorCollection aby získal MyImage. Potom vrátí atributy pro tuto vlastnost a uloží je do proměnné attributes.

Příklad pak vytiskne kategorii načtením CategoryAttribute z AttributeCollectiona zápisem na obrazovku konzoly.

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

Poznámky

Označuje CategoryAttribute kategorii, ke které se má přidružit přidružená vlastnost nebo událost při výpisu vlastností nebo událostí v ovládacím prvku nastaveném PropertyGrid na Categorized režim. CategoryAttribute Pokud nebyl použit na vlastnost nebo událost, přidruží PropertyGrid ho ke kategorii Misc (Různé). Novou kategorii lze vytvořit pro libovolný název zadáním názvu kategorie v konstruktoru CategoryAttributepro .

Vlastnost Category označuje název kategorie, kterou atribut představuje. Vlastnost Category také poskytuje transparentní lokalizaci názvů kategorií.

Poznámky pro dědice

Pokud použijete jiné názvy kategorií než předdefinované názvy a chcete názvy kategorií lokalizovat, musíte přepsat metodu GetLocalizedString(String) .

Třída CategoryAttribute definuje následující běžné kategorie:

Další informace najdete v tématu Atributy.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• Attribute
• PropertyDescriptor
• EventDescriptor