共用方式為


逐步解說:建立控制項的自訂工具箱圖示

本逐步解說將示範如何為 Windows Presentation Foundation (WPF) 自訂控制項建立工具箱圖示。 當您將自訂控制項加入至工具箱時,這個圖示就會出現在控制項的名稱旁邊。

在這個逐步解說中,您會執行下列工作:

  • 建立 WPF 自訂控制項程式庫專案。

  • 為控制項的工具箱圖示建立自訂點陣圖檔。

  • 在設計階段測試控制項的圖示。

完成時,您就知道要如何建立自訂控制項的工具箱圖示。

注意

根據您目前使用的設定或版本,您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。若要變更設定,請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊,請參閱 Visual Studio 設定

必要條件

您需要下列元件才能完成此逐步解說:

  • Visual Studio 2010.

建立自訂工具箱圖示

若要建立控制項的自訂工具箱圖示,請加入影像,做為控制項專案的內嵌資源。

若要建立自訂工具箱圖示

  1. 在 Visual Basic 或 Visual C# 中,建立名為 CustomControlWithToolboxIcon 的新 WPF 自訂控制項程式庫專案。

    CustomControl1 的程式碼隨即在 [程式碼編輯器] 中開啟。

  2. 從 [專案] 功能表中選取 [加入新項目]。

    [加入新項目] 對話方塊隨即開啟。

  3. 在 [加入新項目] 對話方塊中,選取 [一般] 分類。

  4. 在範本清單中,選取 [點陣圖檔],將新檔案命名為 CustomControl1.Icon.bmp,然後按一下 [加入]。

    影像編輯器隨即開啟。

  5. 在 [屬性] 視窗中,將點陣圖的 [色彩] 屬性設定為 24 位元。

  6. 使用影像編輯器工具,在點陣圖中繪製影像。 如需詳細資訊,請參閱影像編輯器圖示

  7. 在 [方案總管] 中,選取 CustomControl1.Icon.bmp。

  8. 在 [屬性] 視窗中,將 [建置動作] 屬性設定為 [內嵌資源]。

  9. 建置方案。

    如需詳細資訊,請參閱工具箱圖示

測試工具箱圖示

請將 CustomControl1 加入至工具箱,以測試您的自訂工具箱圖示。

若要測試工具箱圖示

  1. 在 Visual Basic 或 Visual C# 中,將名為 TestApplication 的新 WPF 應用程式專案加入至方案。

    MainWindow.xaml 隨即在 WPF Designer中開啟。 在 [工具箱] 中,[CustomControl1] 會出現在 [CustomControlWithToolboxIcon 控制項] 索引標籤中。

    包含自訂控制項的工具箱

  2. 在 [工具箱] 中,以滑鼠右鍵按一下 [CustomControl1],並選取 [刪除]。

  3. 在隨即出現的訊息方塊中,按一下 [確定]。

    [CustomControl1] 隨即從 [工具箱] 移除。

  4. 在 [工具箱] 中,以滑鼠右鍵按一下您要加入控制項的控制項群組,然後從內容功能表中選取 [選擇項目]。

    [選擇工具箱項目] 對話方塊隨即開啟。

  5. 在 [選擇工具箱項目] 對話方塊中,按一下 [WPF 元件] 索引標籤。 如需詳細資訊,請參閱 選擇工具箱項目、 WPF 元件

  6. 按一下 [瀏覽],並巡覽至 CustomControlWithToolboxIcon 專案的 bin\Debug 資料夾。

  7. 在 [開啟] 對話方塊中,選取 CustomControlWithToolboxIcon.dll,然後按一下 [開啟]。

    CustomControlWithToolboxIcon 組件 (Assembly) 的詳細資料隨即出現在 [選擇工具箱項目] 對話方塊中。 您的自訂圖示則會出現在 [CustomControl1] 群組方塊中。

  8. 按一下 [確定]。

    [CustomControl1] 隨即連同其對應圖示出現在 [工具箱] 中。

    自訂工具箱圖示

請參閱

工作

HOW TO:將圖示內嵌至組件中

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

概念

工具箱圖示

其他資源

選擇工具箱項目、 WPF 元件

使用資源