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

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 siguientes tareas:

• 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 icono del 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 se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

• Visual Studio 2010.

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 la lista de plantillas, seleccione Archivo de mapa de bits, denomine el nuevo archivo CustomControl1.Icon.bmp y, a continuación, 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 del cuadro de herramientas.

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.

   MainWindow.xaml se abre en WPF Designer. En el cuadro de herramientas, CustomControl1 aparece en la pestaña Controles CustomControlWithToolboxIcon.

   

2. En el cuadro de herramientas, haga clic con el botón secundario del mouse en CustomControl1 y seleccione Eliminar.

3. En el cuadro de mensaje que aparece, haga clic en Aceptar.

   CustomControl1 se quita del cuadro de herramientas.

4. En el cuadro de herramientas, haga clic con el botón secundario en el grupo de control donde desea agregar el control y, a continuación, seleccione Elegir elementos en el menú contextual.

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

5. 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 (Pestaña), Elegir elementos del cuadro de herramientas (Cuadro de diálogo).

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

7. En el cuadro de diálogo Abrir, seleccione CustomControlWithToolboxIcon.dll y haga clic en Abrir.

   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.

8. 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

Referencia

Componentes WPF (Pestaña), Elegir elementos del cuadro de herramientas (Cuadro de diálogo)

Otros recursos

Iconos del cuadro de herramientas

Usar recursos

Tutorial: Proporcionar metadatos para los iconos del cuadro de herramientas