共用方式為


工具箱圖示

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

支援的檔案類型

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

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

注意

Expression Blend 只支援 .png 檔案。

命名規範

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

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

注意

考量到回溯相容性,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 Designer 會優先採用名稱中有 "VisualStudio" 的圖示,而非名稱中有 "Expression" 的圖示。

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

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

覆寫預設工具箱圖示

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

請參閱

工作

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

概念

Visual Studio 2008 的工具箱圖示