CategoryAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.Primitives.dll

Zdroj:

CategoryAttribute.cs

Určuje název kategorie, do které se má vlastnost nebo událost seskupit, pokud se zobrazí v ovládacím PropertyGrid prvku nastaveném na režim zařazený do kategorií.

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

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:

Kategorie	Popis
Action	Vlastnosti související s dostupnými akcemi
Appearance	Vlastnosti související s tím, jak se entita zobrazuje.
Behavior	Vlastnosti související s chováním entity
Data	Vlastnosti související s daty a správou zdrojů dat.
Default	Vlastnosti, které jsou seskupené do výchozí kategorie.
Design	Vlastnosti, které jsou k dispozici pouze v době návrhu.
DragDrop	Vlastnosti související s operacemi přetahování.
Focus	Vlastnosti související s fokusem
Format	Vlastnosti související s formátováním.
Key	Vlastnosti související s klávesnicí
Layout	Vlastnosti související s rozložením
Mouse	Vlastnosti související s myší.
WindowStyle	Vlastnosti související se stylem oken formulářů nejvyšší úrovně.

Další informace najdete v tématu Atributy.

Konstruktory

CategoryAttribute()	Inicializuje novou instanci CategoryAttribute třídy pomocí názvu kategorie Default.
CategoryAttribute(String)	Inicializuje novou instanci CategoryAttribute třídy pomocí zadaného názvu kategorie.

Vlastnosti

Action	Získá představující CategoryAttribute kategorii akce.
Appearance	CategoryAttribute Získá představující kategorii Vzhled.
Asynchronous	CategoryAttribute Získá představující asynchronní kategorii.
Behavior	CategoryAttribute Získá představující kategorii Chování.
Category	Získá název kategorie pro vlastnost nebo událost, na kterou je tento atribut použit.
Data	CategoryAttribute Získá představující kategorii Data.
Default	CategoryAttribute Získá představující výchozí kategorii.
Design	CategoryAttribute Získá představující kategorii Návrh.
DragDrop	CategoryAttribute Získá představující kategorii DragDrop.
Focus	CategoryAttribute Získá představující kategorii Fokus.
Format	CategoryAttribute Získá představující kategorii Formát.
Key	CategoryAttribute Získá představující kategorii Klíč.
Layout	CategoryAttribute Získá představující kategorii Rozložení.
Mouse	CategoryAttribute Získá představující kategorii Myš.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
WindowStyle	CategoryAttribute Získá představující kategorii WindowStyle.

Metody

Equals(Object)	Vrátí, zda je hodnota daného objektu rovna aktuálnímu CategoryAttributeobjektu .
GetHashCode()	Vrátí kód hash pro tento atribut.
GetLocalizedString(String)	Vyhledá lokalizovaný název zadané kategorie.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Určuje, jestli je tento atribut výchozí.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Attribute
• PropertyDescriptor
• EventDescriptor