簡介這份資源面向使用Visual Studio 2010進行Windows桌面開發(fā)的初學(xué)者與進階開發(fā)者系統(tǒng)講解EDIT文本輸入控件的九種典型用法涵蓋基本創(chuàng)建與屬性設(shè)置、事件處理、文本讀寫、輸入限制、多行編輯、格式控制、光標(biāo)與滾動條操作、錯誤提示以及打印預(yù)覽等高級功能幫助讀者解決編輯框在實際項目中的交互與驗證問題。資源包共52個文件約40.82MB包含cpp與h源碼、rc與res資源文件、vcxproj工程配置、sln解決方案以及exe可執(zhí)行文件等構(gòu)成一套可直接編譯運行的完整示例工程便于對照調(diào)試與二次修改。目前已有611人學(xué)習(xí)下載。配合HelpEdit示例資料讀者可掌握GetDlgItemText、SetDlgItemText、EM_SETLIMITTEXT等常用接口理解EN_CHANGE、EN_KILLFOCUS等消息的響應(yīng)時機并借助多行與只讀風(fēng)格、滾動條控制等技巧提升Windows應(yīng)用程序的界面開發(fā)能力。1. 從一次對話框卡死說起VS2010 里 EDIT 控件的真實分量剛?cè)胄心菚何以?VS2010 上做一個串口配置對話框界面上擺了七八個 EDIT 控件用來填波特率、數(shù)據(jù)位、超時時間。程序跑起來看著挺正常直到測試同事在波特率框里敲了一串字母再點確定整個對話框直接卡死任務(wù)管理器都差點沒救回來。排查了半天才發(fā)現(xiàn)問題根本不在串口邏輯而是我把 EDIT 控件當(dāng)成了一個“能顯示文字的框”完全沒管它的樣式、子類化和數(shù)據(jù)校驗。VS2010 的 EDIT 控件看著簡單實際上從窗口樣式、消息處理到 DDX/DDV 數(shù)據(jù)交換每一層都有講究。它解決的是 Windows 原生對話框里最基礎(chǔ)的文本輸入輸出問題適合所有還在維護 MFC 老項目、做工業(yè)上位機、寫配置界面的 C 開發(fā)者。你要是只拖控件不改屬性遲早會踩到我當(dāng)年那個坑。2. 先搞懂 EDIT 控件的三種形態(tài)單行、多行與只讀2.1 單行 EDIT 與多行 EDIT 的樣式差異在 VS2010 的資源編輯器里拖一個 EDIT 控件出來默認(rèn)是單行的。單行和多行的區(qū)別不是“能不能換行”這么簡單它直接決定了控件內(nèi)部的消息處理路徑。單行 EDIT 只處理 WM_CHAR、WM_KEYDOWN 這些基礎(chǔ)輸入消息而多行 EDIT 會額外處理 WM_VSCROLL、WM_HSCROLL還要維護自己的滾動條狀態(tài)。樣式上最關(guān)鍵的幾個宏樣式宏作用適用場景ES_LEFT文本左對齊普通輸入框ES_RIGHT文本右對齊數(shù)字輸入如波特率ES_CENTER文本居中標(biāo)題類只讀框ES_MULTILINE允許多行日志顯示、備注ES_AUTOHSCROLL單行超長自動滾動路徑輸入ES_AUTOVSCROLL多行超長自動滾動日志窗口ES_READONLY只讀狀態(tài)顯示ES_NUMBER只允許數(shù)字端口號、超時我一般會在對話框的 OnInitDialog 里用 ModifyStyle 動態(tài)調(diào)整而不是全在資源編輯器里寫死。比如串口配置對話框波特率框我會在初始化時加上 ES_NUMBER防止用戶輸入字母。// 在對話框類的 OnInitDialog 中動態(tài)設(shè)置 EDIT 樣式 BOOL CSerialCfgDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 獲取波特率編輯框指針 CEdit* pEditBaud (CEdit*)GetDlgItem(IDC_EDIT_BAUD); if (pEditBaud ! NULL) { // 先去掉可能已有的 ES_NUMBER再重新加上避免重復(fù) pEditBaud-ModifyStyle(0, ES_NUMBER | ES_RIGHT); // 限制最大輸入長度為 7 位防止溢出 pEditBaud-SetLimitText(7); } return TRUE; }這段代碼的邏輯是先通過 GetDlgItem 拿到控件指針再用 ModifyStyle 追加 ES_NUMBER 和 ES_RIGHT。SetLimitText 是 CEdit 的成員函數(shù)底層發(fā)的是 EM_SETLIMITTEXT 消息限制用戶能輸入的字符數(shù)。注意 ModifyStyle 的第二個參數(shù)是“要添加的樣式”第一個參數(shù)是“要移除的樣式”別寫反了。2.2 只讀 EDIT 與靜態(tài)文本的選型邊界很多人覺得只讀 EDIT 和 Static Text 看起來一樣隨便用哪個都行。實際項目里我踩過的坑是Static Text 不能滾動不能選中復(fù)制而只讀 EDIT 可以。如果你要顯示一段可能很長的日志或者設(shè)備返回信息用只讀 EDIT 加 ES_MULTILINE | ES_READONLY | WS_VSCROLL用戶還能自己滾動查看。但只讀 EDIT 會接收焦點Tab 鍵會停在上面如果不想讓它參與 Tab 順序得把 WS_TABSTOP 去掉。另一個區(qū)別是背景色。Static Text 默認(rèn)透明背景只讀 EDIT 默認(rèn)是白色背景。在深色主題的工業(yè)界面上只讀 EDIT 需要額外處理 WM_CTLCOLOR 消息來改背景色否則白底黑字特別突兀。// 處理只讀 EDIT 的背景色使其與對話框背景一致 HBRUSH CSerialCfgDlg::OnCtlColor(CDC* pDC, CWnd* pWnd, UINT nCtlColor) { HBRUSH hbr CDialogEx::OnCtlColor(pDC, pWnd, nCtlColor); // 判斷是否是只讀 EDIT 控件 if (nCtlColor CTLCOLOR_EDIT pWnd-GetDlgCtrlID() IDC_EDIT_STATUS) { // 設(shè)置文字顏色為深灰 pDC-SetTextColor(RGB(64, 64, 64)); // 設(shè)置背景顏色為淺灰 pDC-SetBkColor(RGB(240, 240, 240)); // 返回一個淺灰畫刷 static CBrush s_brushStatus(RGB(240, 240, 240)); return (HBRUSH)s_brushStatus.GetSafeHandle(); } return hbr; }這里用 static 畫刷是為了避免每次重繪都創(chuàng)建新畫刷導(dǎo)致 GDI 對象泄漏。OnCtlColor 會被頻繁調(diào)用如果每次 new 一個 CBrush用不了多久就會耗盡 GDI 句柄。這個坑我在一個長時間運行的監(jiān)控程序里遇到過界面跑幾個小時就花屏最后定位就是畫刷沒釋放。3. 數(shù)據(jù)交換與校驗DDX/DDV 在 EDIT 控件上的落地3.1 用 DDX_Text 綁定變量MFC 的 DDXDialog Data Exchange機制是把控件和成員變量關(guān)聯(lián)起來省去手動 GetWindowText/SetWindowText。在 VS2010 里右鍵對話框類 - 添加變量就能給 EDIT 控件綁定一個 CString、int、double 之類的成員變量。綁定之后UpdateData(TRUE) 會把控件里的文本刷到變量UpdateData(FALSE) 會把變量刷到控件。我一般會在 OnInitDialog 末尾調(diào)一次 UpdateData(FALSE) 來初始化界面在 OnOK 里調(diào) UpdateData(TRUE) 來收集數(shù)據(jù)。// 頭文件中聲明成員變量 class CSerialCfgDlg : public CDialogEx { // ... 其他成員 public: int m_nBaudRate; // 綁定 IDC_EDIT_BAUD int m_nDataBits; // 綁定 IDC_EDIT_DATABITS CString m_strPortName; // 綁定 IDC_EDIT_PORT }; // 在 DoDataExchange 中綁定 void CSerialCfgDlg::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); DDX_Text(pDX, IDC_EDIT_BAUD, m_nBaudRate); DDX_Text(pDX, IDC_EDIT_DATABITS, m_nDataBits); DDX_Text(pDX, IDC_EDIT_PORT, m_strPortName); }DDX_Text 對 int 類型會自動做字符串到整數(shù)的轉(zhuǎn)換。如果用戶輸入了非數(shù)字字符UpdateData(TRUE) 會返回 FALSE但不會告訴你具體哪個控件出錯。這時候需要配合 DDV 或者自己寫校驗。3.2 DDV 校驗與自定義校驗函數(shù)DDVDialog Data Validation是在 DDX 之后執(zhí)行的校驗。MFC 自帶了一些常用的 DDV 函數(shù)比如 DDV_MinMaxInt、DDV_MinMaxDouble、DDV_MaxChars。void CSerialCfgDlg::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); DDX_Text(pDX, IDC_EDIT_BAUD, m_nBaudRate); DDV_MinMaxInt(pDX, m_nBaudRate, 300, 115200); // 波特率范圍校驗 DDX_Text(pDX, IDC_EDIT_DATABITS, m_nDataBits); DDV_MinMaxInt(pDX, m_nDataBits, 5, 8); // 數(shù)據(jù)位范圍校驗 DDX_Text(pDX, IDC_EDIT_PORT, m_strPortName); DDV_MaxChars(pDX, m_strPortName, 32); // 端口名最大長度 }DDV_MinMaxInt 會在值超出范圍時彈出默認(rèn)的提示框并把焦點定位到出錯的控件上。但默認(rèn)提示框是英文的而且樣式很老。我一般會重寫 OnDataExchangeError 或者用自定義校驗函數(shù)來替換。// 自定義校驗檢查端口名是否為空且不含非法字符 void CSerialCfgDlg::DoDataExchange(CDataExchange* pDX) { CDialogEx::DoDataExchange(pDX); DDX_Text(pDX, IDC_EDIT_PORT, m_strPortName); if (pDX-m_bSaveAndValidate) // 只在收集數(shù)據(jù)時校驗 { if (m_strPortName.IsEmpty()) { AfxMessageBox(_T(端口名不能為空)); pDX-Fail(); // 通知框架校驗失敗焦點會回到控件 return; } // 檢查是否包含空格或特殊字符 for (int i 0; i m_strPortName.GetLength(); i) { TCHAR ch m_strPortName.GetAt(i); if (!_istalnum(ch) ch ! _T(_)) { AfxMessageBox(_T(端口名只能包含字母、數(shù)字和下劃線)); pDX-Fail(); return; } } } }pDX-m_bSaveAndValidate 為 TRUE 表示當(dāng)前是“從控件到變量”的方向也就是用戶點了確定。pDX-Fail() 會拋出異?？蚣懿东@后會把焦點設(shè)回出錯的控件并中止 UpdateData(TRUE) 的后續(xù)操作。這個機制比手動 SetFocus 要可靠得多。4. 避坑EDIT 控件在 VS2010 里的五個血淚教訓(xùn)4.1 現(xiàn)象多行 EDIT 不換行文字全擠在一行原因只加了 ES_MULTILINE沒加 ES_AUTOVSCROLL 和 WS_VSCROLL而且控件高度不夠。另外如果是在資源編輯器里拖的有時候默認(rèn)的“多行”復(fù)選框沒勾上只改了高度實際還是單行樣式。解決在資源編輯器里勾選 Multiline或者代碼里 ModifyStyle(0, ES_MULTILINE | ES_AUTOVSCROLL | WS_VSCROLL)。還要確保控件高度至少能顯示兩行否則滾動條不出現(xiàn)。4.2 現(xiàn)象SetWindowText 之后界面沒刷新原因在非 UI 線程里直接調(diào)用了 SetWindowText或者在一個循環(huán)里頻繁設(shè)置文本消息隊列被阻塞。解決跨線程更新用 PostMessage 發(fā)自定義消息到主線程或者用 SendMessage 但注意死鎖。循環(huán)里更新的話每設(shè)置一次調(diào)一次 UpdateWindow或者用 RedrawWindow。// 自定義消息用于跨線程更新 EDIT 控件 #define WM_UPDATE_EDIT_TEXT (WM_USER 100) // 在工作線程中發(fā)送消息 void CWorkerThread::UpdateStatus(const CString strText) { // 把字符串指針通過 PostMessage 傳出去注意內(nèi)存管理 CString* pStr new CString(strText); ::PostMessage(m_hWndMain, WM_UPDATE_EDIT_TEXT, 0, (LPARAM)pStr); } // 在主線程的消息處理函數(shù)中接收 LRESULT CSerialCfgDlg::OnUpdateEditText(WPARAM wParam, LPARAM lParam) { CString* pStr (CString*)lParam; if (pStr ! NULL) { CEdit* pEdit (CEdit*)GetDlgItem(IDC_EDIT_STATUS); if (pEdit ! NULL) { pEdit-SetWindowText(*pStr); } delete pStr; // 記得釋放 } return 0; }4.3 現(xiàn)象EDIT 控件輸入中文時光標(biāo)位置錯亂原因VS2010 的 MFC 對 IME 的支持在特定輸入法下有問題尤其是多行 EDIT 配合 ES_RIGHT 或 ES_CENTER 時。解決盡量避免在多行 EDIT 上用 ES_RIGHT/ES_CENTER。如果必須用可以在 WM_IME_COMPOSITION 消息里手動處理光標(biāo)位置但更簡單的辦法是換成單行 EDIT 或者用 RichEdit 控件替代。4.4 現(xiàn)象SetLimitText 不生效用戶還是能輸入超長文本原因SetLimitText 必須在控件已經(jīng)創(chuàng)建之后調(diào)用。如果在 OnInitDialog 之前調(diào)控件還沒創(chuàng)建調(diào)用無效。另外如果資源編輯器里設(shè)置了“最大字符數(shù)”代碼里的 SetLimitText 會覆蓋它但順序要對。解決在 OnInitDialog 里調(diào) SetLimitText并且確認(rèn)控件指針有效。如果還是不行檢查是不是用了 ES_MULTILINE多行 EDIT 的默認(rèn)限制是 0x7FFFFFFESetLimitText 對多行也有效但要注意換行符也算字符。4.5 現(xiàn)象DDX 綁定后UpdateData(TRUE) 返回 FALSE 但沒有任何提示原因DDX_Text 對 int 類型轉(zhuǎn)換失敗時會彈一個默認(rèn)的英文提示框但如果對話框的 DoDataExchange 里同時有多個綁定第一個失敗后后面的就不執(zhí)行了。而且如果是在 OnOK 里調(diào) UpdateData(TRUE)失敗后 OnOK 直接返回對話框不關(guān)閉但用戶不知道哪里錯了。解決在 DoDataExchange 里用 pDX-m_bSaveAndValidate 判斷方向自己寫校驗邏輯用 AfxMessageBox 給出中文提示然后 pDX-Fail()。這樣能精確控制提示內(nèi)容和焦點位置。5. 進階用子類化 CEdit 實現(xiàn)輸入過濾與歷史記錄5.1 子類化 CEdit 攔截 WM_CHARMFC 的 CEdit 類本身沒有提供“只允許輸入十六進制字符”這種細(xì)粒度過濾。要實現(xiàn)對輸入內(nèi)容的完全控制得從 CEdit 派生一個子類重寫 OnChar 或者用消息映射攔截 WM_CHAR。// HexEdit.h只允許輸入十六進制字符的 EDIT 控件 class CHexEdit : public CEdit { DECLARE_DYNAMIC(CHexEdit) public: CHexEdit(); virtual ~CHexEdit(); protected: // 重寫 OnChar 實現(xiàn)輸入過濾 virtual void OnChar(UINT nChar, UINT nRepCnt, UINT nFlags); DECLARE_MESSAGE_MAP() }; // HexEdit.cpp BEGIN_MESSAGE_MAP(CHexEdit, CEdit) ON_WM_CHAR() END_MESSAGE_MAP() void CHexEdit::OnChar(UINT nChar, UINT nRepCnt, UINT nFlags) { // 允許退格、刪除、方向鍵等控制字符 if (nChar VK_BACK || nChar VK_DELETE || nChar VK_LEFT || nChar VK_RIGHT) { CEdit::OnChar(nChar, nRepCnt, nFlags); return; } // 只允許 0-9、A-F、a-f if ((nChar _T(0) nChar _T(9)) || (nChar _T(A) nChar _T(F)) || (nChar _T(a) nChar _T(f))) { CEdit::OnChar(nChar, nRepCnt, nFlags); } // 其他字符直接丟棄不調(diào)用基類 }這個子類的關(guān)鍵點是對于允許的字符調(diào)用基類的 OnChar 讓控件正常處理對于不允許的字符直接 return不調(diào)用基類字符就不會出現(xiàn)在編輯框里。注意控制字符退格、刪除、方向鍵必須放行否則用戶沒法修改已輸入的內(nèi)容。5.2 子類化控件的動態(tài)掛載與卸載子類化有兩種方式一種是在資源編輯器里把 EDIT 控件提升為自定義類VS2010 支持這種操作另一種是在運行時動態(tài)子類化。動態(tài)子類化的好處是同一個對話框里可以靈活控制哪些 EDIT 用過濾、哪些不用。// 在對話框頭文件中聲明子類化對象 class CSerialCfgDlg : public CDialogEx { // ... protected: CHexEdit m_editHexAddr; // 十六進制地址輸入框 CHexEdit m_editHexData; // 十六進制數(shù)據(jù)輸入框 }; // 在 OnInitDialog 中動態(tài)子類化 BOOL CSerialCfgDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 把 IDC_EDIT_HEX_ADDR 子類化為 CHexEdit CWnd* pWndAddr GetDlgItem(IDC_EDIT_HEX_ADDR); if (pWndAddr ! NULL) { m_editHexAddr.SubclassDlgItem(IDC_EDIT_HEX_ADDR, this); m_editHexAddr.SetLimitText(8); // 限制 8 個十六進制字符 } // 把 IDC_EDIT_HEX_DATA 子類化為 CHexEdit CWnd* pWndData GetDlgItem(IDC_EDIT_HEX_DATA); if (pWndData ! NULL) { m_editHexData.SubclassDlgItem(IDC_EDIT_HEX_DATA, this); m_editHexData.SetLimitText(64); } return TRUE; }SubclassDlgItem 是 CWnd 的成員函數(shù)它把對話框里的控件和 C 對象綁定起來之后發(fā)給控件的消息會先經(jīng)過 C 對象的消息映射。注意子類化對象必須是對話框類的成員變量不能是局部變量否則函數(shù)返回后對象析構(gòu)消息映射就斷了。5.3 用 EM_SETMARGINS 調(diào)整文本邊距EDIT 控件默認(rèn)的文本邊距很小文字緊貼著邊框看起來不舒服?？梢杂?EM_SETMARGINS 消息來調(diào)整左右邊距。// 調(diào)整 EDIT 控件的內(nèi)部邊距 void CSerialCfgDlg::AdjustEditMargins() { CEdit* pEdit (CEdit*)GetDlgItem(IDC_EDIT_PORT); if (pEdit ! NULL) { // 設(shè)置左邊距為 4 像素右邊距為 4 像素 pEdit-SendMessage(EM_SETMARGINS, EC_LEFTMARGIN | EC_RIGHTMARGIN, MAKELPARAM(4, 4)); } }EM_SETMARGINS 的 wParam 指定要設(shè)置哪邊的邊距EC_LEFTMARGIN 表示左邊距EC_RIGHTMARGIN 表示右邊距。lParam 的低字是左邊距值高字是右邊距值。這個技巧在需要精細(xì)調(diào)整界面布局時很有用尤其是當(dāng) EDIT 控件和旁邊的按鈕或標(biāo)簽需要對齊時。5.4 驗證子類化是否生效的快速方法寫完子類化代碼后怎么確認(rèn)消息確實被攔截了我一般會在 OnChar 里加一個臨時斷點或者用 TRACE 輸出。void CHexEdit::OnChar(UINT nChar, UINT nRepCnt, UINT nFlags) { // 臨時調(diào)試輸出確認(rèn)哪些字符被攔截 TRACE(_T(CHexEdit::OnChar - nChar 0x%02X\n), nChar); if (nChar VK_BACK || nChar VK_DELETE || nChar VK_LEFT || nChar VK_RIGHT) { CEdit::OnChar(nChar, nRepCnt, nFlags); return; } if ((nChar _T(0) nChar _T(9)) || (nChar _T(A) nChar _T(F)) || (nChar _T(a) nChar _T(f))) { CEdit::OnChar(nChar, nRepCnt, nFlags); } else { // 被攔截的字符可以在這里加提示音 ::MessageBeep(MB_ICONWARNING); } }TRACE 只在 Debug 模式下輸出Release 下自動忽略。MessageBeep 是給用戶一個聽覺反饋表示輸入被拒絕了。這兩個小技巧在調(diào)試輸入過濾邏輯時特別省時間。從那以后我每次給 EDIT 控件綁變量之前都會先問自己三個問題這個框是單行還是多行用戶可能輸入什么非法字符數(shù)據(jù)校驗放在 DDX 里還是單獨寫想清楚再動手比事后打補丁強得多。希望幫到你。本文還有配套的精品資源點擊獲取