Tutorial: Rellenar automáticamente el cuadro de herramientas con componentes personalizadosWalkthrough: Automatically Populating the Toolbox with Custom Components

Si los componentes están definidos por un proyecto en la solución actualmente abierta, estas aparecerán automáticamente en el cuadro de herramientas, con ninguna acción requerida por el usuario.If your components are defined by a project in the currently open solution, they will automatically appear in the Toolbox, with no action required by you. Puede rellenar manualmente el cuadro de herramientas con componentes personalizados mediante el uso de la elegir elementos de cuadro de diálogo) (Visual Studio), pero la cuadro de herramientas tiene en cuenta de elementos de la solución de resultados de la compilación con las siguientes características:You can also manually populate the Toolbox with your custom components by using the Choose Toolbox Items Dialog Box (Visual Studio), but the Toolbox takes account of items in your solution's build outputs with all the following characteristics:

Nota

El cuadro de herramientas no sigue las cadenas de referencia, por lo que no muestra los elementos que no se compilan en un proyecto de la solución.The Toolbox does not follow reference chains, so it won't display items that are not built by a project in your solution.

Este tutorial muestra cómo un componente personalizado aparece automáticamente en el cuadro de herramientas una vez que se basa el componente.This walkthrough demonstrates how a custom component automatically appears in the Toolbox once the component is built. Las tareas ilustradas en este tutorial incluyen:Tasks illustrated in this walkthrough include:

  • Crear un proyecto de Windows Forms.Creating a Windows Forms project.

  • Creación de un componente personalizado.Creating a custom component.

  • Creación de una instancia de un componente personalizado.Creating an instance of a custom component.

  • Descarga y carga un componente personalizado.Unloading and reloading a custom component.

Cuando haya terminado, verá que el cuadro de herramientas se rellena con un componente que ha creado.When you are finished, you will see that the Toolbox is populated with a component that you have created.

Crear el proyectoCreate the project

  1. En Visual Studio, cree un proyecto de aplicación basada en Windows llamado ToolboxExample (archivo > New > proyecto > Visual C# o Visual Basic > escritorio clásico de > Windows Forms Aplicación).In Visual Studio, create a Windows-based application project called ToolboxExample (File > New > Project > Visual C# or Visual Basic > Classic Desktop > Windows Forms Application).

  2. Agregue un nuevo componente al proyecto.Add a new component to the project. Asígnele el nombre DemoComponent.Call it DemoComponent.

    Para obtener más información, vea Cómo: Agregar nuevos elementos de proyecto.For more information, see How to: Add New Project Items.

  3. Compile el proyecto.Build the project.

  4. Desde el herramientas menú, haga clic en el opciones elemento.From the Tools menu, click the Options item. Haga clic en General bajo el Diseñador de Windows Forms de elementos y asegúrese de que el AutoToolboxPopulate opción está establecida en True.Click General under the Windows Forms Designer item and ensure that the AutoToolboxPopulate option is set to True.

Cree una instancia de un componente personalizadoCreate an instance of a custom component

El siguiente paso es crear una instancia del componente personalizado en el formulario.The next step is to create an instance of the custom component on the form. Dado que el cuadro de herramientas automáticamente cuentas para el componente nuevo, esto es tan fácil como crear cualquier otro componente o control.Because the Toolbox automatically accounts for the new component, this is as easy as creating any other component or control.

  1. Abra el formulario del proyecto en el Diseñador de formularios.Open the project's form in the Forms Designer.

  2. En el cuadro de herramientas, haga clic en la nueva ficha denominada Componentes ToolboxExample.In the Toolbox, click the new tab called ToolboxExample Components.

    Al hacer clic en la pestaña, verá DemoComponent.Once you click the tab, you will see DemoComponent.

    Nota

    Por motivos de rendimiento, los componentes en el área rellena automáticamente de la cuadro de herramientas no mostrar mapas de bits personalizados y el ToolboxBitmapAttribute no se admite.For performance reasons, components in the auto-populated area of the Toolbox do not display custom bitmaps, and the ToolboxBitmapAttribute is not supported. Para mostrar un icono para un componente personalizado en el cuadro de herramientas, utilice el elegir elementos del cuadro de herramientas cuadro de diálogo para cargar el componente.To display an icon for a custom component in the Toolbox, use the Choose Toolbox Items dialog box to load your component.

  3. Arrastre el componente al formulario.Drag your component onto your form.

    Se crea una instancia del componente y se agrega a la Bandeja de componentes.An instance of the component is created and added to the Component Tray.

Descargar y recargar un componente personalizadoUnload and reload a custom component

El cuadro de herramientas tiene en cuenta los componentes en cada carga de proyecto y, cuando se descarga un proyecto, se quita las referencias a componentes del proyecto.The Toolbox takes account of the components in each loaded project, and when a project is unloaded, it removes references to the project's components.

  1. Descargue el proyecto de la solución.Unload the project from the solution.

    Para obtener más información sobre cómo descargar los proyectos, vea Cómo: Descargar y recargar proyectos.For more information about unloading projects, see How to: Unload and Reload Projects. Si se le solicite guardar, elija .If you are prompted to save, choose Yes.

  2. Agregue un nuevo aplicación Windows proyecto a la solución.Add a new Windows Application project to the solution. Abra el formulario en el diseñador.Open the form in the Designer.

    El Componentes ToolboxExample ficha desde el proyecto anterior es ahora han desaparecido.The ToolboxExample Components tab from the previous project is now gone.

  3. Volver a cargar el ToolboxExample proyecto.Reload the ToolboxExample project.

    El Componentes ToolboxExample pestaña ahora vuelve a aparecer.The ToolboxExample Components tab now reappears.

Pasos siguientesNext steps

En este tutorial se muestra que el cuadro de herramientas tiene en cuenta los componentes de un proyecto, pero la cuadro de herramientas es también tiene en cuenta los controles.This walkthrough demonstrates that the Toolbox takes account of a project's components, but the Toolbox is also takes account of controls. Experimentar con sus propios controles personalizados mediante la adición y eliminación de proyectos de control de la solución.Experiment with your own custom controls by adding and removing control projects from your solution.

Vea tambiénSee also