在C#中為自定義控件設置工具箱圖標，可通過以下步驟實現：

?

### 步驟說明：

1. **準備圖標文件**??

? ?- 創建或選擇一個16x16像素的位圖（.bmp）文件，建議使用透明背景以確保清晰顯示。

?

2. **添加位圖到項目**??

? ?- 在Visual Studio中，右鍵項目選擇 **添加 → 現有項**，導入位圖文件。

? ?- 在屬性窗口中，將位圖的 **生成操作** 設置為 **嵌入的資源**。

?

3. **應用 ToolboxBitmap 特性**??

? ?- 在自定義控件類上方添加 `[ToolboxBitmap]` 特性，指定資源路徑。例如：

? ? ?```csharp

? ? ?[ToolboxBitmap(typeof(MyControl), "MyNamespace.MyControlIcon.bmp")]

? ? ?public class MyControl : Control

? ? ?{

? ? ? ? ?// 控件代碼

? ? ?}

? ? ?```

? ?- **參數說明**：

? ? ?- `typeof(MyControl)`：指定控件類型，用于解析命名空間。

? ? ?- `"MyNamespace.MyControlIcon.bmp"`：資源路徑，格式為 `命名空間.文件名.擴展名`。

?

4. **重新生成并驗證**??

? ?- 重新生成項目，確保資源嵌入成功。

? ?- 在工具箱中刷新或重新添加控件，查看圖標是否更新。

?

### 完整示例代碼：

```csharp

using System.ComponentModel;

using System.Windows.Forms;

?

namespace MyCustomControls

{

? ? [ToolboxBitmap(typeof(MyButton), "MyCustomControls.MyButton.bmp")]

? ? public class MyButton : Button

? ? {

? ? ? ? // 自定義按鈕的實現

? ? }

}

```

?

### 注意事項：

- **資源路徑**：確保命名空間和文件名正確。若位圖位于子文件夾，路徑應為 `命名空間.文件夾.文件名.bmp`。

- **設計時刷新**：若圖標未更新，嘗試從工具箱中移除控件后重新添加，或重啟Visual Studio。

- **圖標尺寸**：使用16x16像素以避免縮放失真。

?

### 常見問題排查：

- **圖標未顯示**：檢查資源名稱是否正確，生成操作是否為“嵌入的資源”。

- **圖標模糊**：確認位圖尺寸為16x16，并避免復雜圖案。

- **生成錯誤**：確保文件未被其他進程占用，路徑無拼寫錯誤。

?

通過以上步驟，自定義控件在工具箱中將顯示專屬圖標，提升開發體驗。