C++Builder 自定義 VCL 組件開發：命名規範、圖標製作與安裝避坑全記錄

開發自定義 VCL 組件能將重複 UI 邏輯封裝為可視化設計時元件，提升團隊開發效率。本文針對初學者易踩的「類名/單元命名」、「設計時圖標」、「包專案命名」三大痛點給出標準化流程。

核心命名鐵律

關鍵陷阱：若包專案命名為 MyComponent.bpk（缺 T），編譯輸出的 .bpl 會覆蓋同名單元源檔，導致源碼丟失。

設計時圖標製作標準流程

1. 開啟 C++Builder 附帶 Image Editor。
2. File → New → Component Resource File (.dcr)。
3. Resource → Bitmap，設定 24×24 像素、256 色。
4. 將預設資源名 Bitmap1 重命名為 全大寫類名（如 TMYCOMPONENT）。
5. 繪製或貼上圖標（支援從 Photoshop 複製貼上）。
6. 儲存為 全大寫類名.dcr（如 MYCOMPONENT.dcr），置於單元同目錄。
7. 重新 Component → Install Component 安裝，工具箱即顯示自定義圖標。

安裝步驟標準化

1. Component → New Component，祖先類選 TComponent / TGraphicControl 等，類名填 TMyComponent，單元名自動生成 MyComponent。
2. 編寫組件邏輯（__published 發佈屬性/事件，protected 覆寫 Paint 等）。
3. Component → Install Component → Into new package：

• Unit file name：MyComponent.cpp（含路徑）
• Package file name：TMyComponent.bpk（含路徑，**必須含 T**）

4. 編譯安裝，IDE 重啟後工具箱出現組件。

常見問題速查

• 圖標不顯示：檢查 .dcr 檔名、資源名是否全大寫類名；位圖尺寸是否 24×24；色深是否 ≤256 色。
• 屬性不出現在 Object Inspector：確認屬性在 __published 區段，且型別為 VCL 支援型別（String, Color, Font 等）。
• 設計時崩潰：Paint 中避免耗時操作；Constructor 僅初始化，複雜資源延遲至 Loaded 或運行時建立。

遵循上述命名與圖標規範，可讓自定義組件在團隊專案中長期穩定複用，避免「找不到圖標、包名衝突、源碼被覆蓋」等低級錯誤。