CategoryAttribute Classe

Definizione

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

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.

IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
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)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a

Vedi anche