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