Udostępnij za pośrednictwem


CategoryAttribute Klasa

Definicja

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
public class CategoryAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
Dziedziczenie
CategoryAttribute
Atrybuty

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.

IsDefaultAttribute()

W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej.

(Odziedziczone po Attribute)
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)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie obiektu, którego można użyć do pobrania informacji o typie interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też