元件定位
`TDBEdit` (資料感知編輯框) 位於 **Data Controls** 頁面,用於**檢視與編輯**資料集當前記錄的**單一欄位值**。它是 `TDataSource` → `TDataSet` → `TField` 的視覺化介面。
核心屬性詳解
| 屬性 |
類型/值 |
說明 |
備註 |
| DataSource |
TDataSource |
指定資料來源元件,連結至 `TDataSet` (如 `TADOQuery`、`TClientDataSet`)。 |
設計時從下拉選單選擇;執行期可動態指派。 |
| DataField |
string |
指定要綁定的**欄位名稱** (需存在於 DataSource.DataSet.Fields 中)。 |
區分大小寫視資料庫而定;拼錯會運行時報錯或顯示空白。 |
| ReadOnly |
Boolean (Default: False) |
True = 僅顯示不可編輯;False = 可編輯 (視 DataSet 狀態)。 |
常配合 `DataSet.CanModify` 邏輯控制。 |
| Enabled |
Boolean (Default: True) |
False 時呈灰色、不可聚焦、不可編輯、Tab 鍵跳過。 |
不同於 ReadOnly:Enabled=False 連滑鼠選取都無效。 |
| Color |
TColor |
背景顏色。常用於 `ReadOnly=True` 時設為 `clInfoBk` 或 `clBtnFace` 視覺提示。 |
|
| Font |
TFont |
字型設定。 |
|
| MaxLength |
Integer (Default: 0 無限制) |
限制輸入字元數。建議同步資料庫欄位長度 (如 `VARCHAR(50)` → `MaxLength=50`)。 |
0 表示不限制 (受限於欄位定義)。 |
| PasswordChar |
Char (Default: #0) |
設定遮罩字元 (如 `*`、`●`),用於密碼欄位。 |
僅影響顯示,不影響實際資料值。 |
| AutoSelect |
Boolean (Default: True) |
True 時獲得焦點自動全選文字,方便覆寫。 |
|
| AutoSize |
Boolean (Default: False) |
True 時依字型高度自動調整控件高度。 |
|
關鍵事件
| 事件 |
觸發時機 |
典型用途 |
| OnChange |
文字內容變更並失去焦點或按 Enter |
即時驗證、計算衍生欄位、啟用「儲存」按鈕 |
| OnKeyPress / OnKeyDown / OnKeyUp |
鍵盤輸入 |
限制輸入字元 (如只允許數字)、Enter 鍵換行/送出、Esc 取消編輯 |
| OnEnter / OnExit |
焦點進入/離開 |
Enter:高亮提示、顯示說明;Exit:資料格式驗證、格式化 (如金額加千分位) |
| OnClick / OnDblClick |
滑鼠點擊/雙擊 |
雙擊開啟下拉選單、日曆選擇器、查詢視窗 |
| OnContextPopup |
右鍵/選單鍵彈出前 |
動態建立右鍵選單 (複製/貼上/清除/查詢相關資料) |
資料流向與狀態同步
使用者輸入
↓
OnChange / OnExit 驗證
↓
TDBEdit 修改 TField.Value (內部呼叫 DataSet.Edit/Post 流程)
↓
DataSet.Post → 寫入快取/資料庫
↓
其他資料感知控件 (DBGrid, DBLabel 等) 自動重繪 (DataLink 機制)
實務進階技巧
1. 動態切換 DataField (同一 DBEdit 顯示不同欄位)
procedure TForm1.SwitchField(const FieldName: string);
begin
DBEdit1.DataSource := nil; // 先斷開避免觸發事件
DBEdit1.DataField := FieldName;
DBEdit1.DataSource := DataSource1;
end;
2. 格式化顯示 (如金額、日期) — 使用 TField.DisplayFormat
// 在 DataSet 開啟後或 Fields Editor 設定
with DataModule1.ADOQuery1 do
begin
FieldByName('Amount').DisplayFormat := '#,##0.00'; // 顯示千分位
FieldByName('BirthDate').DisplayFormat := 'yyyy/mm/dd';
FieldByName('Status').DisplayValues := '1:啟用;0:停用'; // 布林/代碼顯示中文
end;
// DBEdit 會自動套用 DisplayFormat 顯示,編輯時仍為原始值
3. 輸入掩碼 (TMaskEdit 對應) — DBEdit 無內建,改用 TDBMaskEdit (第三方) 或 OnKeyPress 手工實作
4. 唯讀視覺回饋
procedure TForm1.SetReadOnlyVisual(DBEdit: TDBEdit; ReadOnly: Boolean);
begin
DBEdit.ReadOnly := ReadOnly;
DBEdit.Color := IfThen(ReadOnly, clInfoBk, clWindow);
DBEdit.Font.Color := IfThen(ReadOnly, clGrayText, clWindowText);
end;
常見錯誤與排查
| 現象 |
可能原因 |
檢查項目 |
| 顯示空白、無資料 |
DataField 拼錯、DataSource 未連結、DataSet 未 Active |
檢查 `DataSource.DataSet.Active`、 `DataSource.DataSet.FieldByName(DataField)` 是否存在 |
| 無法編輯 |
ReadOnly=True、DataSet.CanModify=False、DataSet 非 Edit/Insert 狀態 |
確認 `DataSet.CanModify`、按下「新增/編輯」按鈕讓 DataSet 進入 `dsEdit`/`dsInsert` 狀態 |
| 修改後資料未存入資料庫 |
未呼叫 `DataSet.Post`、交易未 Commit、資料庫權限不足 |
檢查導航列/儲存按鈕是否執行 `Post`、`ApplyUpdates`、`Commit` |
| 輸入中文亂碼 |
資料庫字元集/連線字串 Charset 不匹配 |
ADO: `Charset=CP950` (繁中) / `UTF-8`; FD: `CharacterSet` 參數 |
結語
`TDBEdit` 是 Delphi 資料庫應用最基礎的編輯元件,掌握 **DataSource/DataField 綁定、ReadOnly/Enabled 語意差異、DisplayFormat 格式化、事件驗證流程**,即能構建穩健的資料輸入介面。進階場景可結合 `TField.OnValidate`、`TDataSet.OnBeforePost` 實現集中式業務規則驗證。