DesignerCategoryAttribute Clase

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.

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
Herencia
DesignerCategoryAttribute
Atributos

Ejemplos

En el ejemplo siguiente se crea una MyFormclase denominada.The following example creates a class called MyForm. MyFormtiene DesignerAttribute dos atributos, que especifican que esta clase DocumentDesignerusa y DesignerCategoryAttribute que especifica la 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

En el ejemplo siguiente se crea una MyForminstancia de.The next example creates an instance of MyForm. A continuación, obtiene los atributos de la clase, extrae DesignerCategoryAttributee 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 de diseñador para informar a un entorno de desarrollo del tipo de diseñador que se va a implementar.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 del diseñador en una clase, un entorno de desarrollo puede permitir o no que se diseñe la clase.If no designer category is provided on a class, a development environment may or may not allow the class to be designed. Se puede crear una categoría para cualquier nombre.A category can be created for any name.

Cuando se marca 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. Si desea comprobar el valor de este atributo en el código, debe especificar el miembro de constante.When you want to check the value of this attribute in your code, you must specify the constant member. En la columna Descripción de la tabla siguiente se muestra el miembro constante en el que se establece cada valor.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 utilizan con los componentes de.Designers that are used with components. El atributo se establece en el miembro DesignerCategoryAttribute.Componentde constante.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 DesignerCategoryAttribute.Formde constante.The attribute is set to the constant member DesignerCategoryAttribute.Form.
DiseñadorDesigner Diseñadores que se utilizan con diseñadores.Designers that are used with designers. El atributo se establece en el miembro DesignerCategoryAttribute.Genericde constante.The attribute is set to the constant member DesignerCategoryAttribute.Generic.
Cadena vacía ("")Empty String ("") Esta es 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.

(Heredado de 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.

(Heredado de Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de 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.

(Heredado de 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.

(Heredado de 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).

(Heredado de 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.

(Heredado de Attribute)

Se aplica a

Consulte también: