Tutorial: Rellenar automáticamente el cuadro de herramientas con componentes personalizados
Si los componentes se definen mediante un proyecto en la solución abierta actualmente, aparecerán automáticamente en el cuadro de herramientas, sin que sea necesaria ninguna acción por su parte. También puede rellenar manualmente el cuadro de herramientas con los componentes personalizados mediante el cuadro de diálogo Elegir elementos del cuadro de herramientas (Visual Studio), pero el cuadro de herramientas tiene en cuenta los elementos de las salidas de compilación de la solución con todas las características siguientes:
Implementa IComponent;
No tiene ToolboxItemAttribute establecido en
falseNo tiene DesignTimeVisibleAttribute establecido en
false
Nota:
El cuadro de herramientas no sigue las cadenas de referencia, por lo que no mostrará elementos que no se compilen mediante un proyecto en la solución.
En este tutorial se muestra cómo un componente personalizado aparece automáticamente en el cuadro de herramientas una vez compilado ese componente. Las tareas ilustradas en este tutorial incluyen:
Creación de un proyecto de Windows Forms
Creación de un componente personalizado
Creación de una instancia de un componente personalizado
Descarga y nueva carga de un componente personalizado
Cuando termine, verá que el cuadro de herramientas se rellena con el componente que ha creado.
Crear el proyecto
En Visual Studio, cree un proyecto de aplicación basado en Windows llamado
ToolboxExample(Archivo>Nuevo>Proyecto>Visual C# o Visual Basic>Escritorio clásico>Aplicación de Windows Forms).Agregue un nuevo componente al proyecto. Asígnele el nombre
DemoComponent.Para obtener más información, vea Procedimiento para agregar nuevos elementos de proyecto.
Compile el proyecto.
En el menú Herramientas, haga clic en el elemento Opciones. Haga clic en General en el elemento Diseñador de Windows Forms y asegúrese de que la opción AutoToolboxPopulate está establecida en True.
Creación de una instancia de un componente personalizado
El siguiente paso consiste en crear una instancia del componente personalizado en el formulario. Dado que el cuadro de herramientas tiene en cuenta automáticamente el nuevo componente, esto es tan fácil como crear cualquier otro componente o control.
Abra el formulario del proyecto en el Diseñador de Windows Forms.
En el cuadro de herramientas, haga clic en la nueva pestaña denominada Componentes de ToolboxExample.
Una vez que haga clic en la pestaña, verá DemoComponent.
Nota:
Por motivos de rendimiento, los componentes del área rellenada automáticamente del cuadro de herramientas no muestran mapas de bits personalizados y ToolboxBitmapAttribute no se admite. Para mostrar un icono de un componente personalizado en el cuadro de herramientas, use el cuadro de diálogo Elegir elementos del cuadro de herramientas para cargar el componente.
Arrastre el componente al formulario.
Se crea una instancia del componente y esta se agrega a la bandeja de componentes.
Descarga y nueva carga de un componente personalizado
El cuadro de herramientas tiene en cuenta los componentes de cada proyecto cargado y, cuando un proyecto se descarga, quita las referencias a los componentes de ese proyecto.
Descargue el proyecto de la solución.
Para obtener más información sobre cómo descargar proyectos, vea Procedimiento para descargar y volver a cargar proyectos. Si se le pide que guarde, seleccione Sí.
Agregue un nuevo proyecto de Aplicación Windows a la solución. Abra el formulario en el Diseñador.
La pestaña Componentes de ToolboxExample del proyecto anterior ha desaparecido.
Vuelva a cargar el proyecto
ToolboxExample.Ahora vuelve a aparecer la pestaña Componentes de ToolboxExample.
Pasos siguientes
En este tutorial se muestra que el cuadro de herramientas tiene en cuenta los componentes de un proyecto, perotambién tiene en cuenta los controles. Experimente con sus propios controles personalizados agregando y quitando proyectos de control de la solución.