CategoryAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.Primitives.dll

Źródło:

CategoryAttribute.cs

Określa nazwę kategorii, w której należy grupować właściwość lub zdarzenie, gdy jest wyświetlane w kontrolce ustawionej PropertyGrid na tryb kategoryzowany.

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

W poniższym przykładzie zostanie utworzona 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 do PropertyDescriptorCollection elementu , aby pobrać MyImageelement . Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej attributes.

Następnie przykład drukuje kategorię, pobierając CategoryAttribute ją z elementu AttributeCollection, i pisząc ją 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

A CategoryAttribute wskazuje kategorię, z której ma zostać skojarzona właściwość lub zdarzenie, podczas wyświetlania listy właściwości lub zdarzeń w trybie PropertyGrid kontrolki.Categorized CategoryAttribute Jeśli właściwość lub zdarzenie nie zostały zastosowane, PropertyGrid element kojarzy go z kategorią Misc. Nową kategorię można utworzyć dla dowolnej nazwy, określając nazwę kategorii w konstruktorze dla elementu 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 ze 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 reprezentującą kategorię CategoryAttribute Akcja.
Appearance	Pobiera reprezentującą kategorię CategoryAttribute Wygląd.
Asynchronous	Pobiera kategorię CategoryAttribute asynchroniczną.
Behavior	Pobiera reprezentującą kategorię CategoryAttribute Zachowanie.
Category	Pobiera nazwę kategorii dla właściwości lub zdarzenia, do którego jest stosowany ten atrybut.
Data	Pobiera reprezentującą kategorię CategoryAttribute Dane.
Default	Pobiera reprezentującą kategorię CategoryAttribute Domyślna.
Design	Pobiera reprezentującą kategorię CategoryAttribute Projektowanie.
DragDrop	Pobiera reprezentującą kategorię CategoryAttribute DragDrop.
Focus	Pobiera reprezentującą kategorię Koncentracja CategoryAttribute uwagi.
Format	Pobiera reprezentującą kategorię CategoryAttribute Format.
Key	Pobiera reprezentującą kategorię CategoryAttribute Klucz.
Layout	Pobiera reprezentującą kategorię CategoryAttribute Układ.
Mouse	Pobiera reprezentującą kategorię CategoryAttribute Mysz.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
WindowStyle	Pobiera reprezentującą 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 bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	Określa, czy ten atrybut jest domyślny.
Match(Object)	W przypadku zastąpienia 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