CategoryAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

netstandard.dll, System.ComponentModel.Primitives.dll

Zdroj:

CategoryAttribute.cs

Určuje název kategorie, ve které chcete seskupit vlastnost nebo událost při zobrazení v ovládacím prvku PropertyGrid nastaven 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.
        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. Nejprve kód získá PropertyDescriptorCollection všechny vlastnosti objektu. Dále se kód indexuje do získání PropertyDescriptorCollectionMyImage. Pak vrátí atributy pro tuto vlastnost a uloží je do proměnné attributes.

Příklad pak vytiskne kategorii načtením CategoryAttribute z objektu AttributeCollectiona jeho 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é chcete přidružit přidruženou 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 nebyla použita u vlastnosti nebo události, PropertyGrid přidruží ji k kategorii Misc. Novou kategorii lze vytvořit pro libovolný název zadáním názvu kategorie v konstruktoru pro .CategoryAttribute

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žíváte jiné názvy kategorií než předdefinované názvy a chcete lokalizovat názvy kategorií, musíte tuto metodu GetLocalizedString(String) přepsat.

Třída CategoryAttribute definuje následující společné kategorie:

Kategorie	Popis
Action	Vlastnosti související s dostupnými akcemi
Appearance	Vlastnosti související s zobrazením entity
Behavior	Vlastnosti související s tím, jak entita funguje.
Data	Vlastnosti související se správou dat a zdrojů dat
Default	Vlastnosti, které jsou seskupeny ve výchozí kategorii.
Design	Vlastnosti, které jsou k dispozici pouze v době návrhu.
DragDrop	Vlastnosti související s operacemi přetažení.
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 okna formulářů nejvyšší úrovně

Další informace naleznete v tématu Atributy.

Konstruktory

Name	Description
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

Name	Description
Action	CategoryAttribute Získá reprezentaci kategorie Akce.
Appearance	CategoryAttribute Získá reprezentaci kategorie Vzhled.
Asynchronous	CategoryAttribute Získá reprezentaci asynchronní kategorie.
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á reprezentaci kategorie Data.
Default	CategoryAttribute Získá reprezentaci výchozí kategorie.
Design	CategoryAttribute Získá reprezentaci kategorie Návrh.
DragDrop	CategoryAttribute Získá reprezentaci DragDrop kategorie.
Focus	CategoryAttribute Získá reprezentaci kategorie Focus.
Format	CategoryAttribute Získá reprezentaci kategorie Formát.
Key	CategoryAttribute Získá reprezentaci kategorie Klíč.
Layout	CategoryAttribute Získá reprezentaci kategorie Rozložení.
Mouse	CategoryAttribute Získá reprezentaci kategorie Mouse.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)
WindowStyle	CategoryAttribute Získá reprezentaci WindowStyle kategorie.

Metody

Name	Description
Equals(Object)	Vrátí, zda hodnota daného objektu je rovna aktuální CategoryAttribute.
GetHashCode()	Vrátí kód hash pro tento atribut.
GetLocalizedString(String)	Vyhledá lokalizovaný název zadané kategorie.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Určuje, zda je tento atribut výchozí.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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