C++Builder VCL 常用元件深度解析：ListBox、ComboBox、按鈕族群、對話框完全指南

VCL (Visual Component Library) 是 C++Builder 快速開發的核心資產。本文系統整理列表框、組合框、標籤、按鈕家族 (Button/BitBtn/SpeedButton)、單選/核取方塊、捲軸、常用對話框等核心元件的屬性、方法、事件與實戰技巧。

列表框與組合框 (ListBox / ComboBox)

核心屬性對照

三種 ComboBox 模式差異

關鍵事件

• OnClick：列表區點選觸發 (編輯區/下拉鈕不觸發)
• OnChange：編輯區文字變更 (僅 csSimple/csDropDown)
• OnDropDown：下拉列表展開
• OnMeasureItem / OnDrawItem：OwnerDraw 模式自繪

按鈕家族

共通核心屬性

三類按鈕差異

單選鈕與核取方塊

• RadioButton：通常置於 RadioGroup 或 GroupBox 實現互斥單選，Checked 屬性讀寫選取狀態
• CheckBox：AllowGrayed=false (預設) → 二態 (Checked/Unchecked)；true → 三態 (cbChecked/cbUnchecked/cbGrayed，用 State 屬性)
• 唯讀顯示技巧：置於 Panel 設 Enabled=false，避免灰顯同時禁用互動

標籤

捲軸

• Kind：sbHorizontal/sbVertical
• Min/Max：範圍
• Position：目前位置
• LargeChange/SmallChange：PageUp/Down、鍵盤方向鍵步進

常用對話框

對話框通用模式

if (OpenDialog1->Execute()) {  // Execute() 返回 true = 用戶按 OK
    Memo1->Lines->LoadFromFile(OpenDialog1->FileName);
}
// 非模態 Find/Replace 需處理 OnFind/OnReplace 事件

Filter 字串格式

// 設計時用 Filter Editor，或手寫：
"文字檔 (*.txt)|*.txt|INI 設定 (*.ini)|*.ini|所有檔 (*.*)|*.*"
// FilterIndex 從 1 起算

熟練掌握 VCL 核心元件特性，能以最少程式碼實現豐富互動，是 C++Builder 高效開發的關鍵技能。