DesignerCategoryAttribute Class

Definición

Especifica que el diseñador de una clase pertenece a una categoría determinada. Specifies that the designer for a class belongs to a certain category.

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class DesignerCategoryAttribute : Attribute
Herencia
DesignerCategoryAttribute
Atributos

Ejemplos

En el ejemplo siguiente se crea una clase denominada MyForm.The following example creates a class called MyForm. MyForm tiene dos atributos, un DesignerAttribute que especifica que esta clase usa el DocumentDesignery un DesignerCategoryAttribute que especifica el Form categoría.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

En el ejemplo siguiente se crea una instancia de MyForm.The next example creates an instance of MyForm. A continuación, obtiene los atributos de la clase, extrae el DesignerCategoryAttribute, e imprime el nombre del diseñador.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

Comentarios

Un diseñador visual puede utilizar una categoría del diseñador para informar a un entorno de desarrollo del tipo de diseñador que se implementarán.A visual designer can use a designer category to inform a development environment of the type of designer that will be implemented. Si no se proporciona ninguna categoría Diseñador en una clase, un entorno de desarrollo puede permite o no la clase diseñarse.If no designer category is provided on a class, a development environment may or may not allow the class to be designed. Puede crear una categoría para cualquier nombre.A category can be created for any name.

Al marcar una clase con este atributo, se establece en un miembro de constante.When you mark a class with this attribute, it is set to a constant member. Cuando desea comprobar el valor de este atributo en el código, debe especificar al miembro constante.When you want to check the value of this attribute in your code, you must specify the constant member. La columna de descripción en la tabla siguiente enumera al miembro de constante que cada valor está establecido en.The Description column in the table below lists the constant member that each value is set to.

La DesignerCategoryAttribute clase define las siguientes categorías comunes:The DesignerCategoryAttribute class defines the following common categories:

CategoríaCategory DescripciónDescription
ComponenteComponent Diseñadores que se usan con los componentes.Designers that are used with components. El atributo se establece en el miembro constante DesignerCategoryAttribute.Component.The attribute is set to the constant member DesignerCategoryAttribute.Component.
FormForm Diseñadores que se usan con formularios.Designers that are used with forms. El atributo se establece en el miembro constante DesignerCategoryAttribute.Form.The attribute is set to the constant member DesignerCategoryAttribute.Form.
DiseñadorDesigner Diseñadores que se usan con los diseñadores.Designers that are used with designers. El atributo se establece en el miembro constante DesignerCategoryAttribute.Generic.The attribute is set to the constant member DesignerCategoryAttribute.Generic.
Una cadena vacía ("")Empty String ("") Se trata de la categoría predeterminada.This is the default category.

Para obtener más información, consulte Attributes (Atributos).For more information, see Attributes.

Constructores

DesignerCategoryAttribute()

Inicializa una nueva instancia de la clase DesignerCategoryAttribute con una cadena vacía (""). Initializes a new instance of the DesignerCategoryAttribute class with an empty string ("").

DesignerCategoryAttribute(String)

Inicializa una nueva instancia de la clase DesignerCategoryAttribute con el nombre de categoría dado. Initializes a new instance of the DesignerCategoryAttribute class with the given category name.

Campos

Component

Especifica que un componente marcado con esta categoría utiliza un diseñador de componentes. Specifies that a component marked with this category use a component designer. Este campo es de solo lectura. This field is read-only.

Default

Especifica que un componente marcado con esta categoría no puede utilizar un diseñador de componentes. Specifies that a component marked with this category cannot use a visual designer. Este campo static es de solo lectura. This static field is read-only.

Form

Especifica que un componente marcado con esta categoría utiliza un diseñador de formularios. Specifies that a component marked with this category use a form designer. Este campo static es de solo lectura. This static field is read-only.

Generic

Especifica que un componente marcado con esta categoría utiliza un diseñador genérico. Specifies that a component marked with this category use a generic designer. Este campo static es de solo lectura. This static field is read-only.

Propiedades

Category

Obtiene el nombre de la categoría. Gets the name of the category.

TypeId

Obtiene un identificador único para este atributo. Gets a unique identifier for this attribute.

Métodos

Equals(Object)

Devuelve un valor que indica si el valor del objeto especificado es igual al atributo DesignOnlyAttribute actual. Returns whether the value of the given object is equal to the current DesignOnlyAttribute.

GetHashCode()

Devuelve el código hash de esta instancia. Returns the hash code for this instance.

GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

Determina si este atributo es el valor predeterminado. Determines if this attribute is the default.

Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. 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 superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. 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 el número de interfaces de información de tipo que proporciona un objeto (0 ó 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)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto. Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a

Consultar también