Tutorial: Crear un icono de cuadro de herramientas personalizado para un control

Actualización: noviembre 2007

En este tutorial se muestra cómo crear un icono de cuadro de herramientas para un control personalizado de Windows Presentation Foundation (WPF). Al agregar el control personalizado al cuadro de herramientas, el icono aparece junto al nombre de control.

En este tutorial realizará las tareas siguientes:

• Crear un proyecto de biblioteca de controles personalizados de WPF.

• Crear un archivo de mapa de bits personalizado para el icono de cuadro de herramientas del control.

• Probar el control en tiempo de diseño.

Cuando haya finalizado, sabrá crear un icono de cuadro de herramientas para un control personalizado.

Nota:
Los cuadros de diálogo y comandos de menú que verá pueden variar con respecto a los descritos en la Ayuda en función de su edición o configuración activa. Para cambiar su configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

• Visual Studio 2008.

Crear un icono de cuadro de herramientas personalizado

Para crear un icono de cuadro de herramientas personalizado para un control, agregue una imagen como recurso incrustado al proyecto del control.

Para crear un icono de cuadro de herramientas personalizado

1. Cree un nuevo proyecto de biblioteca de controles personalizados de WPF en Visual Basic o Visual C# denominado CustomControlWithToolboxIcon.

   El código de CustomControl1 se abre en el Editor de código.

2. En el menú Proyecto, elija Agregar nuevo elemento.

   Se abrirá el cuadro de diálogo Agregar nuevo elemento.

3. En el cuadro de diálogo Agregar nuevo elemento, seleccione la categoría General.

4. En el panel Plantillas, seleccione Archivo de mapa de bits, denomine el nuevo archivo CustomControl1.Icon.bmp y haga clic en Agregar. Se abrirá el Editor de imágenes.

5. En la ventana Propiedades, establezca la propiedad Colors del mapa de bits en 24 bit.

6. Utilice las herramientas del Editor de imágenes para pintar una imagen en el mapa de bits. Para obtener más información, vea Editor de imágenes.

7. En el Explorador de soluciones, seleccione CustomControl1.Icon.bmp.

8. En la ventana Propiedades, establezca la propiedad Build Action en Recurso incrustado.

9. Genere la solución.

   Para obtener más información, vea Iconos de barras de herramientas y recursos incrustados.

Probar el icono de cuadro de herramientas

Pruebe el icono de cuadro de herramientas personalizado agregando CustomControl1 al cuadro de herramientas.

Para probar el icono de cuadro de herramientas

1. Agregue un nuevo proyecto de aplicación WPF en Visual Basic o Visual C# denominado TestApplication a la solución.

   Window1.xaml se abrirá en WPF Designer.

2. Agregue una referencia al proyecto CustomControlWithToolboxIcon.

3. En el cuadro de herramientas, haga clic con el botón secundario y seleccione Elegir Elementos del menú contextual.

   Se abrirá el cuadro de diálogo Elegir elementos del cuadro de herramientas.

4. En el cuadro de diálogo Elegir elementos del cuadro de herramientas, haga clic en la ficha Componentes WPF . Para obtener más información, vea Componentes WPF (Ficha), Elegir elementos del cuadro de herramientas (Cuadro de diálogo).

5. Haga clic en Examinar y navegue a la carpeta bin\Debug de proyecto CustomControlWithToolboxIcon.

6. Haga doble clic en CustomControlWithToolboxIcon.dll para seleccionarlo.

   En el cuadro de diálogo Elegir elementos del cuadro de herramientas aparecen detalles del ensamblado CustomControlWithToolboxIcon. Su icono personalizado aparece en el cuadro de grupo CustomControl1.

7. Haga clic en Aceptar.

   CustomControl1 aparece en el cuadro de herramientas con su icono correspondiente.

Vea también

Tareas

Cómo: Incrustar un icono en un ensamblado

Conceptos

Iconos de barras de herramientas y recursos incrustados

Otros recursos

Conceptos de extensibilidad básica