CategoryAttribute CategoryAttribute CategoryAttribute CategoryAttribute Class

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.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
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
Ereditarietà
CategoryAttributeCategoryAttributeCategoryAttributeCategoryAttribute
Attributi

Esempi

L'esempio seguente crea il MyImage proprietà.The following example creates the MyImage property. La proprietà dispone di due attributi: una DescriptionAttribute e un 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

L'esempio successivo Ottiene la categoria per MyImage.The next example gets the category for MyImage. Prima di tutto 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, viene eseguita l'indicizzazione nel PropertyDescriptorCollection per ottenere MyImage.Next, the code indexes into the PropertyDescriptorCollection to get MyImage. Quindi restituisce 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 visualizzata la categoria recuperando CategoryAttribute dal AttributeCollectione scriverlo nella finestra 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)

Commenti

Oggetto CategoryAttribute indica la categoria da associare alla proprietà associata o un evento associato, quando si elencano le proprietà o eventi in un PropertyGrid controllo impostato su Categorized modalità.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 eventi, il PropertyGrid associa il varie categoria.If a CategoryAttribute has not been applied to a property or event, the PropertyGrid associates it with the Misc category. Una nuova categoria può essere creata per ogni 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.

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

Note per gli eredi

Se si utilizzano nomi di categoria diversi da quelli predefiniti e si desidera localizzare i nomi di categoria, è necessario eseguire l'override di GetLocalizedString(String) (metodo).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.

Il CategoryAttribute classe 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à relative all'aspetto di un'entità.Properties related to how an entity appears.

Behavior Proprietà correlate al modo in cui un'entità agisce.Properties related to how an entity acts.

Data Proprietà correlate ai dati e gestione delle origini dati.Properties related to data and data source management.

Default Proprietà che vengono raggruppate in una categoria predefinita.Properties that are grouped in a default category.

Design Proprietà che sono disponibili solo in fase di progettazione.Properties that are available only at design time.

DragDrop Proprietà correlate alle operazioni di trascinamento e rilascio.Properties related to drag-and-drop operations.

Focus Proprietà correlate allo stato attivo.Properties related to focus.

Format Proprietà relative 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 del form principale.Properties related to the window style of top-level forms.

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

Costruttori

CategoryAttribute() CategoryAttribute() CategoryAttribute() 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) CategoryAttribute(String) CategoryAttribute(String) 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.

Proprietà

Action Action Action Action

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

Appearance Appearance Appearance Appearance

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

Asynchronous Asynchronous Asynchronous Asynchronous

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

Behavior Behavior Behavior Behavior

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

Category Category 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 Data Data Data

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

Default Default Default Default

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

Design Design Design Design

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

DragDrop DragDrop DragDrop DragDrop

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

Focus Focus Focus Focus

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

Format Format Format Format

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

Key Key Key Key

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

Layout Layout Layout Layout

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

Mouse Mouse Mouse Mouse

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

TypeId TypeId TypeId 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 WindowStyle WindowStyle WindowStyle

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

Metodi

Equals(Object) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

GetLocalizedString(String) GetLocalizedString(String) GetLocalizedString(String) GetLocalizedString(String)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

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

Match(Object) Match(Object) Match(Object) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _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) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _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) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _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)

Si applica a

Vedi anche