Visual Studio 2008 的工具箱圖示
您可以在 Visual Studio 中，將工具箱圖示包含在自訂 Windows Presentation Foundation (WPF) 控制項中。 本主題說明如何命名工具箱圖示，以及如何包含這些圖示來做為內嵌資源。
.gif "注意事項") 注意事項 |
|---|
保留本主題的目的是為了提供與 Visual Studio 2008 的回溯相容性。 若為 Visual Studio 2010，請參閱工具箱圖示。 |
支援的檔案類型
下表列出 WPF Designer for Visual Studio 中支援的工具箱圖示檔案類型。
XAML
BMP
GIF
JPG
JPEG
PNG
命名規範
您可以遵照命名規範，讓工具箱圖示與自訂控制項產生關聯。 WPF Designer for Visual Studio 會檢查控制項組件 (Assembly) 中的內嵌資源，尋找具有適當名稱的影像檔。
在最簡單的情況下，您可以將工具箱圖示影像檔當做內嵌資源，加入至控制項的專案中。 請將它命名為 ControlName.Extension。 WPF 設計工具會搜尋檔名與控制項之型別名稱相符的資源。 如需詳細資訊，請參閱逐步解說：建立控制項的自訂工具箱圖示。
| 注意事項 |
|---|
WPF 設計工具會使用比對演算法，尋找適用於工具箱圖示的最佳資源。 如果資源檔不是有效的 XAML 或有效的影像檔，則會使用下一個符合項目，直到找到有效的檔案為止。XAML 影像不能包含非系統型別的參考。 |
完全相符的名稱
工具箱圖示命名規範支援完全相符的資源名稱。 如果要使用完全相符的名稱，請使用下列規範在工具箱圖示中加入命名空間：Namespace.ControlName.Icon.Extension。 例如，假設某個控制項的名稱為 ProseControl 且其定義包含在 Proseware.Core.Controls 命名空間中， 則此控制項的完全相符 PNG 工具箱圖示將會命名為 Proseware.Core.Controls.ProseControl.Icon.png。
對於資源，Visual Studio 會自動將資料夾轉換為命名空間。 因此，您可以在專案中建立一個與命名空間相同的資料夾結構。 請注意，資料夾會影響在其中找到內嵌資源的命名空間。在前述範例中，如果影像檔位於名為 Icons 的子資料夾中，WPF 設計工具便會尋找名稱為 Proseware.Core.Controls.Icons.ProseControl.Icon.png 的工具箱圖示。
如果在與控制項相同的命名空間中找不到影像，WPF 設計工具將會搜尋部分相符的項目。
部分相符的名稱
如果 WPF 設計工具找不到完全相符的資源，便會在組件的內嵌資源中尋找部分相符的項目。 在前述範例中，WPF 設計工具會先搜尋具有完全相符名稱 Proseware.Core.Controls.ProseControl.Icon.Extension 的檔案。 如果這項搜尋失敗，WPF 設計工具便會忽略命名空間，改成只根據型別名稱來尋找名稱。 在這個範例中，WPF 設計工具將會尋找名為 ProseControl.Icon.Extension 之資源中的任何檔案。如果這項搜尋失敗，WPF 設計工具就會從預設命名空間開始搜尋。 在這個範例中，WPF 設計工具會搜尋名稱為 Proseware.ProseControl.Icon.Extension 的檔案。
多重影像大小
工具箱圖示影像檔的名稱可能包含選擇性 (Optional) 的 "Icon" 欄位。 這個子字串可以讓您指定圖示的多重影像大小。
針對前述範例的 ProseControl 控制項，WPF 設計工具會在資源中尋找下列影像，並選取大小最符合的項目。
Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png
您也可以省略 "Icon" 後面的句號，指定下列檔名。
Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png
WPF 設計工具會根據下列規則來選取工具箱圖示。
向量 XAML。
兩個維度大小完全相符的項目。
大小和外觀比例最接近的相符項目。
點陣圖架構之檔案格式的建議影像大小是 64 像素 x 64 像素。
WPF 設計工具和 Expression Blend 使用不同影像大小的工具箱圖示。 Expression Blend 使用 24x24 做為大型圖示的尺寸，而小型圖示的尺寸則是 12x12。 WPF 設計工具使用的尺寸是 16x16。
如果主機需要的大小是 64x64 像素，而 Proseware.Core.Controls.ProseControl.Icon.Large.png 又是大小和外觀最符合的項目，就會使用這個檔案。 系統會檢查組件中的所有影像。 如果有兩個影像的大小和外觀相同，便由主機決定要使用哪一個影像。