ThumbnailAttribute (Clase)

Artículo
08/10/2011

Asocia un icono a un control Windows Presentation Foundation (WPF) o Silverlight personalizado en el cuadro de herramientas para Visual Studio o Expression Blend.

Jerarquía de herencia

System.Object
System.Attribute
Microsoft.Windows.Design.ThumbnailAttribute

Espacio de nombres: Microsoft.Windows.Design
Ensamblado: Microsoft.Windows.Design.Interaction (en Microsoft.Windows.Design.Interaction.dll)

Sintaxis

'Declaración
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)]
public sealed class ThumbnailAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, AllowMultiple = true)]
public ref class ThumbnailAttribute sealed : public Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)>]
type ThumbnailAttribute =  
    class
        inherit Attribute
    end

public final class ThumbnailAttribute extends Attribute

El tipo ThumbnailAttribute expone los siguientes miembros.

Constructores

	Nombre	Descripción
	ThumbnailAttribute	Inicializa una nueva instancia de la clase ThumbnailAttribute.

Arriba

Propiedades

	Nombre	Descripción
	ResourceAssembly	Obtiene el ensamblado que contiene la imagen del icono.
	ResourceName	Obtiene el nombre de la imagen del icono.
	TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).

Arriba

Métodos

	Nombre	Descripción
	Equals	Infraestructura. Devuelve un valor que indica si esta instancia equivale a un objeto especificado. (Se hereda de Attribute).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Devuelve el código hash de esta instancia. (Se hereda de Attribute).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	IsDefaultAttribute	Cuando se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
	Match	Cuando se reemplaza en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Se hereda de Attribute).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	_Attribute.GetIDsOfNames	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
	_Attribute.GetTypeInfo	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
	_Attribute.GetTypeInfoCount	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Se hereda de Attribute).
	_Attribute.Invoke	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).

Arriba

Comentarios

Aplique ThumbnailAttribute para asignar un icono de cuadro de herramientas a un control WPF o Silverlight personalizado.

Los pasos siguientes muestran cómo agregar a un tipo un icono que representa el control.

Cree un ensamblado de metadatos en tiempo de diseño para el control personalizado. Para obtener más información, vea Tutorial: Proporcionar metadatos personalizados en tiempo de diseño.
Agregue una imagen en la misma jerarquía de carpetas que el tipo que pasa a ThumbnailAttribute. Las extensiones y tipos de archivo admitidos son BMP, GIF, JPG, JPEG y PNG.

Los diferentes hosts de diseñador utilizan tamaños de imagen diferentes para el icono del cuadro de herramientas. Puede especificar una imagen diferente para WPF Designer y Expression Blend si especifica ThumbnailAttribute en los ensamblados de metadatos específicos del host, *.VisualStudio.Design.dll y *.Expression.Design.dll.

Expression Blend utiliza 24x24 para el tamaño grande y 12x12 para el tamaño pequeño de icono. WPF Designer usa 16x16. Para obtener más información, vea Iconos del cuadro de herramientas.
En la ventana Propiedades, establezca la acción de compilación para la imagen en EmbeddedResource.

Nota

Las subcarpetas del proyecto afectan al espacio de nombres en el que se encuentran los recursos incrustados.
Implemente la interfaz IProvideAttributeTable para agregar ThumbnailAttribute a la clase del control. Puede utilizar la misma imagen en varios tipos si aplica el mismo ThumbnailAttribute a varios controles.

ThumbnailAttribute también se utiliza para buscar un icono predeterminado para los tipos agregados a la funcionalidad de "nueva instancia" del Editor de colecciones o del Editor de subpropiedades.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.