DesignerCategoryAttribute DesignerCategoryAttribute DesignerCategoryAttribute DesignerCategoryAttribute Class

Definizione

Specifica che la finestra di progettazione di una classe appartiene a una determinata categoria.Specifies that the designer for a class belongs to a certain category.

public ref class DesignerCategoryAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class DesignerCategoryAttribute : Attribute
type DesignerCategoryAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute
Ereditarietà
DesignerCategoryAttributeDesignerCategoryAttributeDesignerCategoryAttributeDesignerCategoryAttribute
Attributi

Esempi

L'esempio seguente crea una classe denominata MyForm.The following example creates a class called MyForm. MyForm include due attributi, un DesignerAttribute che specifica questa classe Usa il DocumentDesignere una DesignerCategoryAttribute che specifica il Form categoria.MyForm has two attributes, a DesignerAttribute that specifies this class uses the DocumentDesigner, and a DesignerCategoryAttribute that specifies the Form category.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};
[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
    
 public class MyForm : ContainerControl {
    // Insert code here.
 }
<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class 'MyForm

L'esempio seguente crea un'istanza di MyForm.The next example creates an instance of MyForm. Viene quindi ottenuto gli attributi della classe, viene estratto il DesignerCategoryAttribute, e viene stampato il nome della finestra di progettazione.Then it gets the attributes for the class, extracts the DesignerCategoryAttribute, and prints the name of the designer.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the 
       * DesignerCategoryAttribute from the AttributeCollection. */
   DesignerCategoryAttribute^ myAttribute = dynamic_cast<DesignerCategoryAttribute^>(attributes[ DesignerCategoryAttribute::typeid ]);
   Console::WriteLine( "The category of the designer for this class is: {0}", myAttribute->Category );
   return 0;
}
public static int Main() {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the 
     * DesignerCategoryAttribute from the AttributeCollection. */
    DesignerCategoryAttribute myAttribute = 
       (DesignerCategoryAttribute)attributes[typeof(DesignerCategoryAttribute)];
    Console.WriteLine("The category of the designer for this class is: " + myAttribute.Category);
  
    return 0;
}
Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the
    ' DesignerCategoryAttribute from the AttributeCollection. 
    Dim myAttribute As DesignerCategoryAttribute = _
        CType(attributes(GetType(DesignerCategoryAttribute)), DesignerCategoryAttribute)
    Console.WriteLine(("The category of the designer for this class is: " + myAttribute.Category))
    Return 0
End Function 'Main

Commenti

Una finestra di progettazione visiva può utilizzare una categoria della finestra di progettazione per informare un ambiente di sviluppo del tipo di finestra di progettazione che verrà implementato.A visual designer can use a designer category to inform a development environment of the type of designer that will be implemented. Se non viene fornita nessuna categoria della finestra di progettazione in una classe, un ambiente di sviluppo può o potrebbe non essere consentita la progettazione della classe.If no designer category is provided on a class, a development environment may or may not allow the class to be designed. Una categoria può essere creata per qualsiasi nome.A category can be created for any name.

Quando si contrassegna una classe con questo attributo, viene impostata su un membro costante.When you mark a class with this attribute, it is set to a constant member. Quando si desidera controllare il valore di questo attributo nel codice, è necessario specificare il membro costante.When you want to check the value of this attribute in your code, you must specify the constant member. La colonna Descrizione nella tabella seguente elenca il membro costante che ogni valore è impostato su.The Description column in the table below lists the constant member that each value is set to.

Il DesignerCategoryAttribute classe definisce le categorie comuni seguenti:The DesignerCategoryAttribute class defines the following common categories:

CategoryCategory DescrizioneDescription
ComponenteComponent Finestre di progettazione che vengono usati con i componenti.Designers that are used with components. L'attributo è impostato sul membro costante DesignerCategoryAttribute.Component.The attribute is set to the constant member DesignerCategoryAttribute.Component.
FormForm Finestre di progettazione che vengono usati con i moduli.Designers that are used with forms. L'attributo è impostato sul membro costante DesignerCategoryAttribute.Form.The attribute is set to the constant member DesignerCategoryAttribute.Form.
DesignerDesigner Finestre di progettazione che vengono usati con le finestre di progettazione.Designers that are used with designers. L'attributo è impostato sul membro costante DesignerCategoryAttribute.Generic.The attribute is set to the constant member DesignerCategoryAttribute.Generic.
Una stringa vuota ("")Empty String ("") Questa è la categoria predefinita.This is the default category.

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

Costruttori

DesignerCategoryAttribute() DesignerCategoryAttribute() DesignerCategoryAttribute() DesignerCategoryAttribute()

Consente di inizializzare una nuova istanza della classe DesignerCategoryAttribute con una stringa vuota ("").Initializes a new instance of the DesignerCategoryAttribute class with an empty string ("").

DesignerCategoryAttribute(String) DesignerCategoryAttribute(String) DesignerCategoryAttribute(String) DesignerCategoryAttribute(String)

Consente di inizializzare una nuova istanza della classe DesignerCategoryAttribute con il nome di categoria specificato.Initializes a new instance of the DesignerCategoryAttribute class with the given category name.

Campi

Component Component Component Component

Specifica che in un componente contrassegnato con questa categoria viene utilizzata una finestra di progettazione componenti.Specifies that a component marked with this category use a component designer. Questo campo è di sola lettura.This field is read-only.

Default Default Default Default

Specifica che un componente contrassegnato con questa categoria non può utilizzare una finestra di progettazione visiva.Specifies that a component marked with this category cannot use a visual designer. Questo campo static è di sola lettura.This static field is read-only.

Form Form Form Form

Specifica che in un componente contrassegnato con questa categoria viene utilizzata una finestra di progettazione form.Specifies that a component marked with this category use a form designer. Questo campo static è di sola lettura.This static field is read-only.

Generic Generic Generic Generic

Specifica che in un componente contrassegnato con questa categoria viene utilizzata una finestra di progettazione generica.Specifies that a component marked with this category use a generic designer. Questo campo static è di sola lettura.This static field is read-only.

Proprietà

Category Category Category Category

Ottiene il nome della categoria.Gets the name of the category.

TypeId TypeId TypeId TypeId

Ottiene un identificatore univoco per questo attributo.Gets a unique identifier for this attribute.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

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