Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DesignerCategoryAttribute

 

Publicado: octubre de 2016

Especifica que el Diseñador de una clase pertenece a una categoría determinada.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.Attribute
    System.ComponentModel.DesignerCategoryAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = false, 
	Inherited = true)]
public sealed class DesignerCategoryAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodDesignerCategoryAttribute()

Inicializa una nueva instancia de la DesignerCategoryAttribute clase con una cadena vacía ("").

System_CAPS_pubmethodDesignerCategoryAttribute(String)

Inicializa una nueva instancia de la DesignerCategoryAttribute clase con el nombre de la categoría especificada.

NombreDescripción
System_CAPS_pubpropertyCategory

Obtiene el nombre de la categoría.

System_CAPS_pubpropertyTypeId

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene un identificador único para este atributo.(Invalida Attribute.TypeId).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve si el valor del objeto especificado es igual a la actual DesignOnlyAttribute.(Invalida Attribute.Equals(Object)).

System_CAPS_pubmethodGetHashCode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve el código hash de esta instancia.(Invalida Attribute.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si este atributo es el valor predeterminado.(Invalida Attribute.IsDefaultAttribute()).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticComponent

Especifica que un componente marcado con esta categoría utiliza un diseñador de componentes. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticDefault

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Especifica que un componente marcado con esta categoría no puede utilizar un diseñador visual. Esto static campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticForm

Especifica que un componente marcado con esta categoría utiliza un diseñador de formularios. Esto static campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticGeneric

Especifica que un componente marcado con esta categoría utiliza un diseñador genérico. Esto static campo es de solo lectura.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

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. Si no se proporciona ninguna categoría Diseñador en una clase, un entorno de desarrollo puede permite o no la clase diseñarse. Puede crear una categoría para cualquier nombre.

Cuando se marca una clase con este atributo, se establece en un miembro de constante. Cuando desee comprobar el valor de este atributo en el código, deberá especificar al miembro de constante. La columna de descripción en la tabla siguiente muestra al miembro de constante que cada valor.

La DesignerCategoryAttribute clase define las siguientes categorías comunes:

Categoría

Descripción

Componente

Diseñadores que se utilizan con componentes. El atributo se establece en el miembro constante DesignerCategoryAttribute.Component.

Form

Diseñadores que se utilizan con formularios. El atributo se establece en el miembro constante DesignerCategoryAttribute.Form.

Designer

Diseñadores que se utilizan con diseñadores. El atributo se establece en el miembro constante DesignerCategoryAttribute.Generic.

Una cadena vacía ("")

Se trata de la categoría predeterminada.

Para obtener más información, consulta Extender metadatos mediante atributos.

En el ejemplo siguiente se crea una clase denominada MyForm. MyForm tiene dos atributos, un DesignerAttribute que especifica que esta clase usa el DocumentDesigner, y un DesignerCategoryAttribute que especifica la Form categoría.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]

 public class MyForm : ContainerControl {
    // Insert code here.
 }

En el ejemplo siguiente se crea una instancia de MyForm. A continuación, obtiene los atributos de la clase, extrae el DesignerCategoryAttribute, e imprime el nombre del diseñador.

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;
}

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: