Visual Studio 2008 的工具箱圖示

發行項
05/28/2012

您可以在 Visual Studio 中，將工具箱圖示包含在自訂 Windows Presentation Foundation (WPF) 控制項中。本主題說明如何命名工具箱圖示，以及如何包含這些圖示來做為內嵌資源。

注意

保留本主題的目的是為了提供與 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 Designer會搜尋檔名與控制項之型別名稱相符的資源。如需詳細資訊，請參閱逐步解說：建立控制項的自訂工具箱圖示。

注意

WPF Designer會使用比對演算法，尋找適用於工具箱圖示的最佳資源。如果資源檔不是有效的 XAML 或有效的影像檔，則會使用下一個符合項目，直到找到有效的檔案為止。XAML 影像不能包含非系統型別的參考。

完全相符的名稱

工具箱圖示命名規範支援完全相符的資源名稱。如果要使用完全相符的名稱，請使用下列規範在工具箱圖示中加入命名空間：Namespace.ControlName.Icon.Extension。例如，假設某個控制項的名稱為 ProseControl 且其定義包含在 Proseware.Core.Controls 命名空間中，則此控制項的完全相符 PNG 工具箱圖示將會命名為 Proseware.Core.Controls.ProseControl.Icon.png。

對於資源，Visual Studio 會自動將資料夾轉換為命名空間。因此，您可以在專案中建立一個與命名空間相同的資料夾結構。請注意，資料夾會影響在其中找到內嵌資源的命名空間。在前述範例中，如果影像檔位於名為 Icons 的子資料夾中，WPF Designer便會尋找名稱為 Proseware.Core.Controls.Icons.ProseControl.Icon.png 的工具箱圖示。

如果在與控制項相同的命名空間中找不到影像，WPF Designer將會搜尋部分相符的項目。

部分相符的名稱

如果 WPF Designer找不到完全相符的資源，便會在組件的內嵌資源中尋找部分相符的項目。在前述範例中，WPF Designer會先搜尋具有完全相符名稱 Proseware.Core.Controls.ProseControl.Icon.Extension 的檔案。如果這項搜尋失敗，WPF Designer便會忽略命名空間，改成只根據型別名稱來尋找名稱。在這個範例中，WPF Designer將會尋找名為 ProseControl.Icon.Extension 之資源中的任何檔案。如果這項搜尋失敗，WPF Designer就會從預設命名空間開始搜尋。在這個範例中，WPF Designer會搜尋名稱為 Proseware.ProseControl.Icon.Extension 的檔案。

多重影像大小

工具箱圖示影像檔的名稱可能包含選擇性 (Optional) 的 "Icon" 欄位。這個子字串可以讓您指定圖示的多重影像大小。

針對前述範例的 ProseControl 控制項，WPF Designer會在資源中尋找下列影像，並選取大小最符合的項目。

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 Designer會根據下列規則來選取工具箱圖示。

向量 XAML。
兩個維度大小完全相符的項目。
大小和外觀比例最接近的相符項目。

點陣圖架構之檔案格式的建議影像大小是 64 像素 x 64 像素。

WPF Designer和 Expression Blend 使用不同影像大小的工具箱圖示。 Expression Blend 使用 24x24 做為大型圖示的尺寸，而小型圖示的尺寸則是 12x12。 WPF Designer使用的尺寸是 16x16。

如果主機需要的大小是 64x64 像素，而 Proseware.Core.Controls.ProseControl.Icon.Large.png 又是大小和外觀最符合的項目，就會使用這個檔案。系統會檢查組件中的所有影像。如果有兩個影像的大小和外觀相同，便由主機決定要使用哪一個影像。

請參閱

共用方式為