ThumbnailAttribute 类

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

将图标与 Visual Studio 或 Expression Blend 的工具箱中的自定义 Windows Presentation Foundation (WPF) 或 Silverlight 控件关联。

继承层次结构

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

命名空间： Microsoft.Windows.Design
程序集： Microsoft.Windows.Design.Interaction（在 Microsoft.Windows.Design.Interaction.dll 中）

语法

声明
<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

ThumbnailAttribute 类型公开以下成员。

构造函数

	名称	说明
	ThumbnailAttribute	初始化 ThumbnailAttribute 类的新实例。

页首

属性

	名称	说明
	ResourceAssembly	获取包含图标图像的程序集。
	ResourceName	获取图标图像的名称。
	TypeId	当在派生类中实现时，获取该 Attribute 的唯一标识符。（继承自 Attribute。）

页首

方法

	名称	说明
	Equals	基础结构。返回一个值，该值指示此实例是否与指定的对象相等。（继承自 Attribute。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
	GetHashCode	返回此实例的哈希代码。（继承自 Attribute。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	IsDefaultAttribute	当在派生类中重写时，指示此实例的值是否是派生类的默认值。（继承自 Attribute。）
	Match	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。（继承自 Attribute。）
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

显式接口实现

	名称	说明
	_Attribute.GetIDsOfNames	将一组名称映射为对应的一组调度标识符。（继承自 Attribute。）
	_Attribute.GetTypeInfo	检索对象的类型信息，然后可以使用该信息获取接口的类型信息。（继承自 Attribute。）
	_Attribute.GetTypeInfoCount	检索对象提供的类型信息接口的数量（0 或 1）。（继承自 Attribute。）
	_Attribute.Invoke	提供对某一对象公开的属性和方法的访问。（继承自 Attribute。）

页首

备注

应用 ThumbnailAttribute 为自定义 WPF 控件或 Silverlight 控件分配工具箱图标。

下面的步骤演示如何将表示控件的图标添加到类型中。

为自定义控件创建一个设计时元数据程序集。有关更多信息，请参见演练：提供自定义设计时元数据。
在与传递到 ThumbnailAttribute 的类型相同的文件夹层次结构上添加一个图像。支持的扩展名和文件类型有 BMP、GIF、JPG、JPEG 和 PNG。

不同的设计器宿主对工具箱图标使用不同的图像大小。通过在宿主特定的元数据程序集 *.VisualStudio.Design.dll 和 *.Expression.Design.dll. 中指定 ThumbnailAttribute，可以为 WPF Designer和 Expression Blend 指定不同的图像。

Expression Blend 对大图标大小使用 24x24，对小图标大小使用 12x12。 WPF Designer使用 16x16。有关更多信息，请参见工具箱图标。
在“属性”窗口中，将图像的生成操作设置为**“EmbeddedResource”**。

备注

项目子文件夹会影响在其中查找嵌入资源的命名空间。
实现 IProvideAttributeTable 接口以将 ThumbnailAttribute 添加到控件的类。通过将同一 ThumbnailAttribute 应用于多个控件，可以在多个类型之间重用同一图像。

还可以使用 ThumbnailAttribute 查找添加到集合编辑器或子属性编辑器“新建实例”功能的类型的默认图标。