共用方式為


工具箱圖示

您可以在 Visual Studio 和 Expression Blend 中,將工具箱圖示包含在自訂 WPF 和 Silverlight 控制項中。 本主題說明如何命名工具箱圖示,以及如何包含這些圖示來做為內嵌資源。

支援的檔案類型

下列清單顯示 WPF Designer for Visual Studio 中支援的工具箱圖示檔案類型。 

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

注意事項注意事項

Expression Blend 只支援 .png 檔案。

命名規範

您可以遵照命名規範,讓工具箱圖示與自訂控制項產生關聯。 設計工具會檢查控制項組件中的內嵌資源,尋找具有適當名稱的影像檔。

在最簡單的情況下,您可以將工具箱圖示影像檔當做內嵌資源,加入至控制項的專案中。 請將它命名為 ControlName.Extension,然後在 [屬性] 視窗中,將其 [建置動作] 設定為 [內嵌資源]。 WPF 設計工具會搜尋檔名與控制項之型別名稱相符的資源。 如需詳細資訊,請參閱逐步解說:建立控制項的自訂工具箱圖示

注意事項注意事項

考量到回溯相容性,Visual Studio 2010 支援 Visual Studio 2008 使用的命名慣例。 如需詳細資訊,請參閱Visual Studio 2008 的工具箱圖示

Visual Studio 2010 支援下列工具箱圖示命名慣例。 方括號 ([]) 中的子字串是選擇項。

[AnyString]Namespace.ControlName[.Product][.AnyString].Extension

當設計工具搜尋工具箱圖示時,它會比對 Namespace、ControlName 和 Product 子字串。 如果 Namespace 和 ControlName 與您的控制項不符,圖示便不會顯示在工具箱中。

設計工具可能會使用 Product 子字串來篩選出其他產品的圖示。 例如,Visual Studio 慣用的圖示會將 Product 設定為 "VisualStudio"。

下列清單顯示可用於 Visual Studio 和 Expression Blend 圖示的範例工具箱圖示命名慣例。

  • Namespace.ControlName.VisualStudio.Extension

  • Namespace.ControlName.VisualStudio.AnyString.Extension

  • Namespace.ControlName.Expression.png

  • Namespace.ControlName.Expression.AnyString.png

如果找不到符合上述名稱的圖示,便會搜尋下列名稱。

  • Namespace.ControlName.Extension

  • Namespace.ControlName.AnyString.Extension

下列清單顯示 TailspinToysControlLibrary 命名空間中名為 TailspinToysControl 之控制項的範例工具箱圖示名稱。 其中加上有關影像格式的其他選擇性資訊 (設計工具不會使用這些資訊)。

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

在設計工具找到工具箱圖示之後,便會載入並顯示最符合設計工具目標圖示大小的圖示。 下列清單顯示比對準則的套用順序。

  1. 優先選取圖示名稱中有指定設計工具的圖示,而非沒有指定設計工具的圖示。 例如,WPF 設計工具 會優先採用名稱中有 "VisualStudio" 的圖示,而非名稱中有 "Expression" 的圖示。

  2. 選取最符合呈現大小的圖示。 Visual Studio 工具箱會載入最接近 16x16 像素的圖示,然後再將該圖示對應到 24 位元色彩深度。

  3. 選取最先找到的圖示。

覆寫預設工具箱圖示

您可以使用 WPF 設計工具擴充性架構來覆寫內嵌在控制項執行階段組件中的工具箱圖示。 如需詳細資訊,請參閱逐步解說:提供工具箱圖示的中繼資料

請參閱

概念

Visual Studio 2008 的工具箱圖示

其他資源

逐步解說:提供工具箱圖示的中繼資料