Compartir a través de

Iconos del cuadro de herramientas

  • Artículo

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

Tipos de archivo compatibles

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

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

Nota

Expression Blend solo admite archivos .png.

Convención de nomenclatura

Asocie un icono de cuadro de herramientas a un control personalizado siguiendo una convención de nomenclatura. Las herramientas de diseño examinan los recursos incrustados en el ensamblado del 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 NombreDeControl.Extensión y establezca la Acción de compilación en Recurso incrustado en la ventana Propiedades. 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

Para ofrecer compatibilidad con versiones anteriores, Visual Studio 2010 admite la convención de nomenclatura utilizada por Visual Studio 2008. Para obtener más información, vea Iconos del cuadro de herramientas en Visual Studio 2008.

Visual Studio 2010 admite la siguiente convención de nomenclatura para los iconos del cuadro de herramientas. Las subcadenas que aparecen entre corchetes ([]) son opcionales.

[CualquierCadena]EspacioDeNombres.NombreDeControl[.Producto][.CualquierCadena].Extensión

Cuando un diseñador busca iconos del cuadro de herramientas, busca coincidencias con las subcadenas EspacioDeNombres, NombreDeControl y Producto. Si EspacioDeNombres y NombreDeControl no coinciden con el control, el icono no se mostrará en el cuadro de herramientas.

Un diseñador puede usar la subcadena Producto a fin de filtrar los iconos para otros productos. Por ejemplo, Visual Studio prefiere los iconos que tengan establecido "VisualStudio" como Producto.

En la lista siguiente se muestran convenciones de nomenclatura para iconos del cuadro de herramientas de ejemplo que se pueden usar para los iconos de Visual Studio y Expression Blend.

  • EspacioDeNombres.NombreDeControl.VisualStudio.Extensión

  • EspacioDeNombres.NombreDeControl.VisualStudio.CualquierCadena.Extensión

  • EspacioDeNombres.NombreDeControl.Expression.png

  • EspacioDeNombres.NombreDeControl.Expression.CualquierCadena.png

Si no se encuentra ningún icono que se ajuste a los nombres anteriores, se buscan los siguientes nombres.

  • EspacioDeNombres.NombreDeControl.Extensión

  • EspacioDeNombres.NombreDeControl.CualquierCadena.Extensión

En la lista siguiente se muestran iconos del cuadro de herramientas de ejemplo para un control denominado TailspinToysControl en el espacio de nombres TailspinToysControlLibrary. Se agrega información opcional adicional sobre el formato de la imagen, pero los diseñadores no la usan.

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

Una vez que un diseñador encuentra iconos del cuadro de herramientas, se carga y se muestra el icono que más se aproxime al tamaño del icono de destino del diseñador. En la lista siguiente se muestra el orden en el que se aplican los criterios de coincidencia.

  1. Seleccione preferentemente los iconos en los que se especifica el diseñador en el nombre frente a aquellos en los que no se especifica un diseñador. Por ejemplo, WPF Designer prefiere los iconos que incluyen "VisualStudio" en el nombre frente a aquellos que incluyen "Expression".

  2. Seleccione el icono que más se aproxime al tamaño de presentación. El cuadro de herramientas de Visual Studio carga el icono más cercano a 16x16 píxeles y, a continuación, asigna a dicho icono una profundidad de color de 24 bits.

  3. Seleccione el icono encontrado en primer lugar.

Invalidar los iconos predeterminados del cuadro de herramientas

Puede usar el marco de extensibilidad de WPF Designer para invalidar los iconos del cuadro de herramientas incrustados en un ensamblado del runtime de un control. Para obtener más información, vea Tutorial: Proporcionar metadatos para los iconos del cuadro de herramientas.

Vea también

Conceptos

Iconos del cuadro de herramientas en Visual Studio 2008

Otros recursos

Tutorial: Proporcionar metadatos para los iconos del cuadro de herramientas