Iconos del cuadro de herramientas en Visual Studio 2008

Artículo
08/10/2011

Puede incluir iconos del cuadro de herramientas con los controles personalizados de Windows Presentation Foundation (WPF) en Visual Studio. En este tema se describe cómo asignar un nombre a los iconos del cuadro de herramientas y cómo incluirlos como recursos incrustados.

Nota

Este tema se mantiene por compatibilidad con versiones anteriores de Visual Studio 2008. Para Visual Studio 2010, vea Iconos del cuadro de herramientas.

Tipos de archivo compatibles

En la tabla siguiente se incluyen los tipos de archivo compatibles con los iconos del cuadro de herramientas en WPF Designer for Visual Studio.

XAML
BMP
GIF
JPG
JPEG
PNG

Convención de nomenclatura

Asocie un icono de cuadro de herramientas a un control personalizado siguiendo una convención de nomenclatura. WPF Designer for Visual Studio examina los recursos incrustados en el ensamblado de control para buscar un archivo de imagen con el nombre apropiado.

En el caso más simple, agregue el archivo de imagen de icono de cuadro de herramientas como un recurso incrustado en el proyecto de control. Denomínelo ControlName.Extension. WPF Designer busca un recurso con un nombre de archivo que coincida con el nombre de tipo del control. Para obtener más información, vea Tutorial: Crear un icono de cuadro de herramientas personalizado para un control.

Nota

WPF Designer utiliza un algoritmo coincidente para buscar el mejor recurso para un icono de cuadro de herramientas. Si un archivo de recursos es no es un archivo XAML válido o un archivo de imagen válido, se utilizará la siguiente coincidencia hasta que se encuentre uno. Las imágenes XAML no pueden contener referencias a tipos que no sean del sistema.

Nombre que coincide totalmente

La convención de nomenclatura de iconos de cuadro de herramientas admite los nombres de recursos que coinciden totalmente. Para los nombres que coinciden totalmente, incluya el espacio de nombres en el nombre del icono de Cuadro de herramientas utilizando la convención siguiente EspacioDeNombres.NombreDeControl.Icono.Extensión. Por ejemplo, considere un control que se denomina ProseControl y se define en el espacio de nombres Proseware.Core.Controls. Un icono de cuadro de herramientas PNG que coincida totalmente para este control se denominaría Proseware.Core.Controls.ProseControl.Icon.png.

Para los recursos, Visual Studio convierte automáticamente las carpetas en espacios de nombres. Por consiguiente, puede crear una estructura de carpetas en el proyecto que sea igual que el espacio de nombres. Tenga en cuenta que las carpetas afectan al espacio de nombres en el que se encuentran los recursos incrustados. En el ejemplo anterior, si el archivo de imagen está en una subcarpeta llamada Icons, WPF Designer buscará un icono del Cuadro de herramientas denominado Proseware.Core.Controls.Icons.ProseControl.Icon.png.

Si una imagen no se encuentra en el mismo espacio de nombres que el control, WPF Designer busca una coincidencia aproximada.

Nombre que coincide aproximadamente

Si WPF Designer no encuentra un recurso que coincida totalmente, busca coincidencias aproximadas en los recursos incrustados del ensamblado. En el ejemplo anterior, WPF Designer busca primero un archivo con el nombre completo Proseware.Core.Controls.ProseControl.Icon.Extensión. Si se produce un error en esta búsqueda, WPF Designer omite el espacio de nombres y busca un nombre basado exclusivamente en el nombre del tipo. En este ejemplo, WPF Designer busca los archivos de los recursos denominados ProseControl.Icon.Extensión. Si esta búsqueda no se realiza correctamente, WPF Designer comienza a buscar en el espacio de nombres predeterminado. En este ejemplo, WPF Designer busca archivos denominados Proseware.ProseControl.Icon.Extensión.

Varios tamaños de imagen

El nombre de archivo de imagen de icono de cuadro de herramientas puede incluir un campo "Icon" opcional. Esta subcadena habilita la elección de varios tamaños de imagen para el icono.

Para el control ProseControl del ejemplo anterior, WPF Designer busca las imágenes siguientes en los recursos y selecciona la mejor coincidencia para el tamaño.

Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png

También puede omitir el punto que sigue a "Icon" para especificar los nombres de archivo siguientes.

Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png

WPF Designer selecciona el icono Cuadro de herramientas basado en las reglas siguientes.

XAML vectorial.
Coincidencia exacta de tamaño en ambas dimensiones.
La coincidencia más próxima basada en tamaño y relación de aspecto.

El tamaño de imagen recomendado para los formatos de archivo basados en mapa de bits es 64 píxeles por 64 píxeles.

WPF Designer y Expression Blend utilizan tamaños de imagen diferentes para el icono Cuadro de herramientas. Expression Blend utiliza 24x24 para el tamaño grande y 12x12 para el tamaño pequeño. WPF Designer usa 16x16.

Si el tamaño deseado por el host es 64x64 píxeles y Proseware.Core.Controls.ProseControl.Icon.Large.png es la mejor coincidencia basada en el tamaño y relación de aspecto, se utiliza este archivo. Se examinan todas las imágenes en el ensamblado. Si hay dos imágenes con el mismo tamaño y relación de aspecto, el host decide cuál utiliza.