CategoryAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Quelle:

CategoryAttribute.cs

Gibt den Namen der Kategorie an, in der die Eigenschaft oder das Ereignis bei der Anzeige in einem PropertyGrid-Steuerelement gruppiert werden soll, das auf den Modus Nach Kategorien festgelegt ist.

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

Vererbung

Object

Attribute

CategoryAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird die MyImage -Eigenschaft erstellt. Die Eigenschaft verfügt über zwei Attribute: a DescriptionAttribute und 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

Im nächsten Beispiel wird die Kategorie für MyImageabgerufen. Zunächst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das -Objekt ab. Als Nächstes wird der Code in den PropertyDescriptorCollection indiziert, um abzurufen MyImage. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Variablen attributesgespeichert.

Das Beispiel gibt dann die Kategorie aus, indem sie von AttributeCollectionabgerufen CategoryAttribute und in den Konsolenbildschirm geschrieben wird.

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

Hinweise

A CategoryAttribute gibt die Kategorie an, der die zugeordnete Eigenschaft oder das zugehörige Ereignis zugeordnet werden soll, wenn Eigenschaften oder Ereignisse in einem PropertyGrid Steuerelementsatz im Modus aufgelistet werden Categorized . Wenn ein CategoryAttribute nicht auf eine Eigenschaft oder ein Ereignis angewendet wurde, ordnet es der PropertyGrid Kategorie "Misc " zu. Eine neue Kategorie kann für jeden Namen erstellt werden, indem der Name der Kategorie im Konstruktor für angegeben CategoryAttributewird.

Die Category -Eigenschaft gibt den Namen der Kategorie an, die das Attribut darstellt. Die Category Eigenschaft bietet auch eine transparente Lokalisierung von Kategorienamen.

Hinweise für Vererber

Wenn Sie andere Kategorienamen als die vordefinierten Namen verwenden und Ihre Kategorienamen lokalisieren möchten, müssen Sie die GetLocalizedString(String) -Methode überschreiben.

Die CategoryAttribute -Klasse definiert die folgenden allgemeinen Kategorien:

Category	BESCHREIBUNG
Action	Eigenschaften im Zusammenhang mit verfügbaren Aktionen.
Appearance	Eigenschaften, die sich auf die Darstellung einer Entität beziehen.
Behavior	Eigenschaften im Zusammenhang mit der Handlung einer Entität.
Data	Eigenschaften im Zusammenhang mit der Daten- und Datenquellenverwaltung.
Default	Eigenschaften, die in einer Standardkategorie gruppiert sind.
Design	Eigenschaften, die nur zur Entwurfszeit verfügbar sind.
DragDrop	Eigenschaften im Zusammenhang mit Drag-and-Drop-Vorgängen.
Focus	Eigenschaften im Zusammenhang mit dem Fokus.
Format	Eigenschaften im Zusammenhang mit der Formatierung.
Key	Eigenschaften im Zusammenhang mit der Tastatur.
Layout	Eigenschaften im Zusammenhang mit dem Layout.
Mouse	Eigenschaften im Zusammenhang mit der Maus.
WindowStyle	Eigenschaften im Zusammenhang mit dem Fensterstil von Formularen der obersten Ebene.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

CategoryAttribute()	Initialisiert eine neue Instanz der CategoryAttribute-Klasse unter Verwendung des Kategorienamens Standard.
CategoryAttribute(String)	Initialisiert eine neue Instanz der CategoryAttribute-Klasse unter Verwendung des angegebenen Kategorienamens.

Eigenschaften

Action	Ruft ein CategoryAttribute ab, das die Kategorie Aktion darstellt.
Appearance	Ruft ein CategoryAttribute ab, das die Kategorie Darstellung darstellt.
Asynchronous	Ruft ein CategoryAttribute ab, das die Kategorie Asynchron darstellt.
Behavior	Ruft ein CategoryAttribute ab, das die Kategorie Verhalten darstellt.
Category	Ruft den Namen der Kategorie für die Eigenschaft oder das Ereignis ab, auf die bzw. auf das dieses Attribut angewendet wird.
Data	Ruft ein CategoryAttribute ab, das die Kategorie Daten darstellt.
Default	Ruft ein CategoryAttribute ab, das die Kategorie Standard darstellt.
Design	Ruft ein CategoryAttribute ab, das die Kategorie Entwurf darstellt.
DragDrop	Ruft ein CategoryAttribute ab, das die Kategorie DragDrop darstellt.
Focus	Ruft ein CategoryAttribute ab, das die Kategorie Fokus darstellt.
Format	Ruft ein CategoryAttribute ab, das die Kategorie Format darstellt.
Key	Ruft ein CategoryAttribute ab, das die Kategorie Schlüssel darstellt.
Layout	Ruft ein CategoryAttribute ab, das die Kategorie Layout darstellt.
Mouse	Ruft ein CategoryAttribute ab, das die Kategorie Maus darstellt.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
WindowStyle	Ruft ein CategoryAttribute ab, das die Kategorie Fensterstil darstellt.

Methoden

Equals(Object)	Gibt zurück, ob der Wert des angegebenen Objekts gleich dem aktuellen CategoryAttribute ist.
GetHashCode()	Gibt den Hashcode für dieses Attribut zurück.
GetLocalizedString(String)	Sucht den lokalisierten Namen einer angegebenen Kategorie.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Bestimmt, ob dieses Attribut der Standardwert ist.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Attribute
• PropertyDescriptor
• EventDescriptor