CategoryAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Origine:

CategoryAttribute.cs

Specifica il nome della categoria in cui raggruppare la proprietà o l'evento se visualizzato in un controllo PropertyGrid impostato sulla modalità Per categoria.

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

Ereditarietà

Object

Attribute

CategoryAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene creata la MyImage proprietà . La proprietà ha due attributi: a DescriptionAttribute e un 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

L'esempio successivo ottiene la categoria per MyImage. Prima di tutto, il codice ottiene un PropertyDescriptorCollection con tutte le proprietà per l'oggetto. Successivamente, gli indici di codice nell'oggetto PropertyDescriptorCollection per ottenere MyImage. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributes.

L'esempio stampa quindi la categoria recuperando CategoryAttribute dall'oggetto AttributeCollectione scrivendola nella schermata della console.

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

Commenti

Indica CategoryAttribute la categoria da associare alla proprietà o all'evento associato, quando si elencano proprietà o eventi in un PropertyGrid controllo impostato su Categorized modalità. Se un oggetto CategoryAttribute non è stato applicato a una proprietà o a un evento, lo PropertyGrid associa alla categoria Misc . È possibile creare una nuova categoria per qualsiasi nome specificando il nome della categoria nel costruttore per CategoryAttribute.

La Category proprietà indica il nome della categoria rappresentata dall'attributo. La Category proprietà fornisce anche la localizzazione trasparente dei nomi di categoria.

Note per gli eredi

Se si usano nomi di categoria diversi dai nomi predefiniti e si desidera localizzare i nomi delle categorie, è necessario eseguire l'override del GetLocalizedString(String) metodo.

La CategoryAttribute classe definisce le categorie comuni seguenti:

Category	Descrizione
Action	Proprietà correlate alle azioni disponibili.
Appearance	Proprietà correlate alla modalità di visualizzazione di un'entità.
Behavior	Proprietà correlate al modo in cui un'entità agisce.
Data	Proprietà correlate alla gestione dei dati e dell'origine dati.
Default	Proprietà raggruppate in una categoria predefinita.
Design	Proprietà disponibili solo in fase di progettazione.
DragDrop	Proprietà correlate alle operazioni di trascinamento e rilascio.
Focus	Proprietà correlate allo stato attivo.
Format	Proprietà correlate alla formattazione.
Key	Proprietà correlate alla tastiera.
Layout	Proprietà correlate al layout.
Mouse	Proprietà correlate al mouse.
WindowStyle	Proprietà correlate allo stile della finestra dei moduli di primo livello.

Per altre informazioni, vedere Attributi.

Costruttori

CategoryAttribute()	Consente l'inizializzazione di una nuova istanza della classe CategoryAttribute con il nome di categoria Default.
CategoryAttribute(String)	Consente l'inizializzazione di una nuova istanza della classe CategoryAttribute con il nome di categoria specificato.

Proprietà

Action	Ottiene un attributo CategoryAttribute che rappresenta la categoria Action.
Appearance	Ottiene un attributo CategoryAttribute che rappresenta la categoria Appearance.
Asynchronous	Ottiene un attributo CategoryAttribute che rappresenta la categoria Asynchronous.
Behavior	Ottiene un attributo CategoryAttribute che rappresenta la categoria Behavior.
Category	Ottiene il nome della categoria per la proprietà o l'evento a cui è applicato questo attributo.
Data	Ottiene un attributo CategoryAttribute che rappresenta la categoria Data.
Default	Ottiene un attributo CategoryAttribute che rappresenta la categoria Default.
Design	Ottiene un attributo CategoryAttribute che rappresenta la categoria Design.
DragDrop	Ottiene un attributo CategoryAttribute che rappresenta la categoria DragDrop.
Focus	Ottiene un attributo CategoryAttribute che rappresenta la categoria Focus.
Format	Ottiene un attributo CategoryAttribute che rappresenta la categoria Format.
Key	Ottiene un attributo CategoryAttribute che rappresenta la categoria Key.
Layout	Ottiene un attributo CategoryAttribute che rappresenta la categoria Layout.
Mouse	Ottiene un attributo CategoryAttribute che rappresenta la categoria Mouse.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
WindowStyle	Ottiene un attributo CategoryAttribute che rappresenta la categoria WindowStyle.

Metodi

Equals(Object)	Specifica se il valore dell'oggetto specificato è uguale all'oggetto CategoryAttribute corrente.
GetHashCode()	Restituisce il codice hash per questo attributo.
GetLocalizedString(String)	Consente di cercare il nome localizzato della categoria specificata.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Determina se questo attributo è predefinito.
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Attribute
• PropertyDescriptor
• EventDescriptor