CategoryAttribute Class

Definition

Specifica il nome della categoria in cui raggruppare la proprietà o l'evento se visualizzato in un controllo PropertyGrid impostato sulla modalità Per categoria.Specifies the name of the category in which to group the property or event when displayed in a PropertyGrid control set to Categorized mode.

public ref class CategoryAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute
public class CategoryAttribute : Attribute
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
Inheritance
CategoryAttribute
Attributes

Examples

Nell'esempio seguente viene creata la proprietà MyImage.The following example creates the MyImage property. La proprietà dispone di due attributi: una DescriptionAttribute e una CategoryAttribute.The property has two attributes: a DescriptionAttribute and 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

Nell'esempio seguente viene ottenuta la categoria per MyImage.The next example gets the category for MyImage. Innanzitutto, il codice ottiene un PropertyDescriptorCollection con tutte le proprietà per l'oggetto.First, the code gets a PropertyDescriptorCollection with all the properties for the object. Successivamente, il codice indicizza nel PropertyDescriptorCollection per ottenere MyImage.Next, the code indexes into the PropertyDescriptorCollection to get MyImage. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributes.Then it returns the attributes for this property and saves them in the variable attributes.

Nell'esempio viene quindi stampata la categoria recuperando CategoryAttribute dal AttributeCollectione scrivendolo sullo schermo della console.The example then prints the category by retrieving CategoryAttribute from the AttributeCollection, and writing it to the console screen.

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

Remarks

Un CategoryAttribute indica la categoria a cui associare la proprietà o l'evento associato, quando si elencano proprietà o eventi in un controllo PropertyGrid impostato sulla modalità Categorized.A CategoryAttribute indicates the category to associate the associated property or event with, when listing properties or events in a PropertyGrid control set to Categorized mode. Se un CategoryAttribute non è stato applicato a una proprietà o a un evento, il PropertyGrid lo associa alla categoria varie .If a CategoryAttribute has not been applied to a property or event, the PropertyGrid associates it with the Misc category. È possibile creare una nuova categoria per qualsiasi nome specificando il nome della categoria nel costruttore per la CategoryAttribute.A new category can be created for any name by specifying the name of the category in the constructor for the CategoryAttribute.

La proprietà Category indica il nome della categoria rappresentata dall'attributo.The Category property indicates the name of the category that the attribute represents. La proprietà Category fornisce anche la localizzazione trasparente dei nomi di categoria.The Category property also provides transparent localization of category names.

Notes to Inheritors

Se si utilizzano nomi di categoria diversi da quelli predefiniti e si desidera localizzare i nomi delle categorie, è necessario eseguire l'override del metodo GetLocalizedString(String).If you use category names other than the predefined names, and you want to localize your category names, you must override the GetLocalizedString(String) method.

La classe CategoryAttribute definisce le categorie comuni seguenti:The CategoryAttribute class defines the following common categories:

CategoryCategory DescrizioneDescription
Action Proprietà correlate alle azioni disponibili.Properties related to available actions.
Appearance Proprietà correlate al modo in cui viene visualizzata un'entità.Properties related to how an entity appears.
Behavior Proprietà correlate all'azione di un'entità.Properties related to how an entity acts.
Data Proprietà correlate ai dati e alla gestione dell'origine dati.Properties related to data and data source management.
Default Proprietà raggruppate in una categoria predefinita.Properties that are grouped in a default category.
Design Proprietà disponibili solo in fase di progettazione.Properties that are available only at design time.
DragDrop Proprietà correlate alle operazioni di trascinamento della selezione.Properties related to drag-and-drop operations.
Focus Proprietà correlate allo stato attivo.Properties related to focus.
Format Proprietà correlate alla formattazione.Properties related to formatting.
Key Proprietà correlate alla tastiera.Properties related to the keyboard.
Layout Proprietà correlate al layout.Properties related to layout.
Mouse Proprietà correlate al mouse.Properties related to the mouse.
WindowStyle Proprietà correlate allo stile della finestra dei form di primo livello.Properties related to the window style of top-level forms.

Per altre informazioni, vedere Attributi.For more information, see Attributes.

Constructors

CategoryAttribute()

Consente l'inizializzazione di una nuova istanza della classe CategoryAttribute con il nome di categoria Default.Initializes a new instance of the CategoryAttribute class using the category name Default.

CategoryAttribute(String)

Consente l'inizializzazione di una nuova istanza della classe CategoryAttribute con il nome di categoria specificato.Initializes a new instance of the CategoryAttribute class using the specified category name.

Properties

Action

Ottiene un attributo CategoryAttribute che rappresenta la categoria Action.Gets a CategoryAttribute representing the Action category.

Appearance

Ottiene un attributo CategoryAttribute che rappresenta la categoria Appearance.Gets a CategoryAttribute representing the Appearance category.

Asynchronous

Ottiene un attributo CategoryAttribute che rappresenta la categoria Asynchronous.Gets a CategoryAttribute representing the Asynchronous category.

Behavior

Ottiene un attributo CategoryAttribute che rappresenta la categoria Behavior.Gets a CategoryAttribute representing the Behavior category.

Category

Ottiene il nome della categoria per la proprietà o l'evento a cui è applicato questo attributo.Gets the name of the category for the property or event that this attribute is applied to.

Data

Ottiene un attributo CategoryAttribute che rappresenta la categoria Data.Gets a CategoryAttribute representing the Data category.

Default

Ottiene un attributo CategoryAttribute che rappresenta la categoria Default.Gets a CategoryAttribute representing the Default category.

Design

Ottiene un attributo CategoryAttribute che rappresenta la categoria Design.Gets a CategoryAttribute representing the Design category.

DragDrop

Ottiene un attributo CategoryAttribute che rappresenta la categoria DragDrop.Gets a CategoryAttribute representing the DragDrop category.

Focus

Ottiene un attributo CategoryAttribute che rappresenta la categoria Focus.Gets a CategoryAttribute representing the Focus category.

Format

Ottiene un attributo CategoryAttribute che rappresenta la categoria Format.Gets a CategoryAttribute representing the Format category.

Key

Ottiene un attributo CategoryAttribute che rappresenta la categoria Key.Gets a CategoryAttribute representing the Key category.

Layout

Ottiene un attributo CategoryAttribute che rappresenta la categoria Layout.Gets a CategoryAttribute representing the Layout category.

Mouse

Ottiene un attributo CategoryAttribute che rappresenta la categoria Mouse.Gets a CategoryAttribute representing the Mouse category.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
WindowStyle

Ottiene un attributo CategoryAttribute che rappresenta la categoria WindowStyle.Gets a CategoryAttribute representing the WindowStyle category.

Methods

Equals(Object)

Specifica se il valore dell'oggetto specificato è uguale all'oggetto CategoryAttribute corrente.Returns whether the value of the given object is equal to the current CategoryAttribute.

GetHashCode()

Restituisce il codice hash per questo attributo.Returns the hash code for this attribute.

GetLocalizedString(String)

Consente di cercare il nome localizzato della categoria specificata.Looks up the localized name of the specified category.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

Determina se questo attributo è predefinito.Determines if this attribute is the default.

IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from 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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also