萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Delphi DBEdit 元件核心屬性、事件與使用實務

元件定位

`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` 實現集中式業務規則驗證。

copyright © 萬盛學電腦網 all rights reserved