CategoryAttribute Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvény:

System.dll

Annak a kategóriának a nevét adja meg, amelyben csoportosítani szeretné a tulajdonságot vagy eseményt PropertyGrid , ha kategorizált módban jelenik meg.

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

Öröklődés

Object

Attribute

CategoryAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa létrehozza a tulajdonságot MyImage . A tulajdonságnak két attribútuma van: a DescriptionAttribute és 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

A következő példa a következő kategóriát MyImagekapja meg. Először is a kód lekéri PropertyDescriptorCollection az objektum összes tulajdonságát. Ezután a kód indexel a PropertyDescriptorCollection lekéréshez MyImage. Ezután visszaadja a tulajdonság attribútumait, és menti őket a változóba attributes.

A példa ezután kinyomtatja a kategóriát a beolvasással CategoryAttribute és a AttributeCollectionkonzolképernyőre való írással.

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

Megjegyzések

Az A CategoryAttribute azt a kategóriát jelöli, amellyel társítani szeretné a társított tulajdonságot vagy eseményt, ha egy vezérlőben lévő tulajdonságokat vagy eseményeket PropertyGrid módban listáz.Categorized Ha egy CategoryAttribute tulajdonságra vagy eseményre nincs alkalmazva, akkor a PropertyGridmisc kategóriához társítja azt. Bármely névhez létrehozhat új kategóriát a kategória nevének megadásával a konstruktorban.CategoryAttribute

A Category tulajdonság annak a kategóriának a nevét jelzi, amelyet az attribútum képvisel. A Category tulajdonság a kategórianevek transzparens honosítását is biztosítja.

Megjegyzések az öröklőkhöz

Ha az előre definiált neveken kívül más kategórianeveket használ, és honosítani szeretné a kategórianeveket, felül kell bírálnia a metódust GetLocalizedString(String) .

Az CategoryAttribute osztály a következő gyakori kategóriákat határozza meg:

Kategória	Leírás
Action	Az elérhető műveletekhez kapcsolódó tulajdonságok.
Appearance	Az entitás megjelenésével kapcsolatos tulajdonságok.
Behavior	Az entitások működéséhez kapcsolódó tulajdonságok.
Data	Az adatokkal és az adatforrás-kezeléssel kapcsolatos tulajdonságok.
Default	Az alapértelmezett kategóriában csoportosított tulajdonságok.
Design	Azok a tulajdonságok, amelyek csak a tervezéskor érhetők el.
DragDrop	A húzási műveletekhez kapcsolódó tulajdonságok.
Focus	A fókuszhoz kapcsolódó tulajdonságok.
Format	Formázással kapcsolatos tulajdonságok.
Key	A billentyűzettel kapcsolatos tulajdonságok.
Layout	Az elrendezéshez kapcsolódó tulajdonságok.
Mouse	Az egérrel kapcsolatos tulajdonságok.
WindowStyle	A felső szintű űrlapok ablakstílusához kapcsolódó tulajdonságok.

További információ: Attribútumok.

Konstruktorok

Name	Description
CategoryAttribute()	Inicializálja az osztály új példányát az CategoryAttribute Alapértelmezett kategórianév használatával.
CategoryAttribute(String)	Inicializálja az osztály új példányát a CategoryAttribute megadott kategórianév használatával.

Tulajdonságok

Name	Description
Action	CategoryAttribute Lekéri a Művelet kategóriát.
Appearance	CategoryAttribute Lekéri a Megjelenés kategóriát.
Asynchronous	CategoryAttribute Lekéri az Aszinkron kategóriát.
Behavior	CategoryAttribute Lekéri a Viselkedés kategóriát.
Category	Lekéri annak a tulajdonságnak vagy eseménynek a nevét, amelyet ez az attribútum alkalmaz.
Data	CategoryAttribute Lekéri az Adatkategóriát.
Default	CategoryAttribute Lekéri az Alapértelmezett kategóriát.
Design	CategoryAttribute Lekéri a Tervezés kategóriát.
DragDrop	CategoryAttribute Lekéri a DragDrop kategóriát.
Focus	CategoryAttribute Lekéri a Fókusz kategóriát.
Format	CategoryAttribute Lekéri a Formátum kategóriát.
Key	CategoryAttribute Lekéri a Kulcs kategóriát.
Layout	CategoryAttribute Lekéri az Elrendezés kategóriát.
Mouse	CategoryAttribute Lekéri az Egér kategóriát.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)
WindowStyle	CategoryAttribute Lekéri a WindowStyle kategóriát.

Metódusok

Name	Description
Equals(Object)	Azt adja vissza, hogy az adott objektum értéke megegyezik-e az aktuális CategoryAttributeértékkel.
GetHashCode()	Az attribútum kivonatkódját adja vissza.
GetLocalizedString(String)	Megkeresi a megadott kategória honosított nevét.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Meghatározza, hogy ez az attribútum-e az alapértelmezett érték.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)

Lásd még

• Attribute
• PropertyDescriptor
• EventDescriptor