ThumbnailAttribute 類別

發行項
08/12/2011

在 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 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

明確介面實作

	名稱	說明
	_Attribute.GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	_Attribute.GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	_Attribute.GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	_Attribute.Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 Attribute)。

回頁首

備註

您可以套用 ThumbnailAttribute，將工具箱圖示指派給自訂 WPF 或 Silverlight 控制項。

下列步驟說明如何將代表控制項的圖示加入至型別。

為自訂控制項建立設計階段中繼資料 (Metadata) 組件 (Assembly)。如需詳細資訊，請參閱逐步解說：提供自訂設計階段中繼資料。
在與您傳遞給 ThumbnailAttribute 之型別相同的資料夾階層架構上，加入影像。支援的副檔名和檔案類型為 BMP、GIF、JPG、JPEG 和 PNG。

不同的設計工具主機會使用不同影像大小做為工具箱圖示。您可以在主機特定的中繼資料組件 *.VisualStudio.Design.dll 和 *.Expression.Design.dll 中指定 ThumbnailAttribute，為 WPF 設計工具和 Expression Blend 指定不同的影像。

Expression Blend 使用 24x24 做為大型圖示的尺寸，而小型圖示的尺寸則是 12x12。 WPF 設計工具使用的尺寸是 16x16。如需詳細資訊，請參閱工具箱圖示。
在 [屬性] 視窗中，將影像的建置動作設定為 [EmbeddedResource]。

注意事項

專案子資料夾會影響內嵌資源所在的命名空間。
實作 IProvideAttributeTable 介面，將 ThumbnailAttribute 加入至控制項的類別。您可以將相同的 ThumbnailAttribute 套用至多個控制項，對多個型別重複使用相同的影像。

使用 ThumbnailAttribute，也可以針對加入至 [集合編輯器] 或 [子屬性編輯器] 之「新執行個體」功能的型別，為其尋找預設圖示。