1. 代码开发工具里的计算器困局:为什么按钮事件越写越像补丁
在 VC6.0 这类代码开发工具里,MFC 计算器最容易被写成按钮事件的堆积:每个按钮改一个成员变量,再靠布尔标志判断当前该拼接还是该计算。四则运算刚跑通时看不出问题,一旦加上键盘输入、连续按等号,多算一次的血泪经验就来了。这篇实战教程不铺消息映射全链路,只盯一个角度:把“按钮→字符串拼接→数值计算”重构成四状态机,再用 PreTranslateMessage 接键盘。适合已经能在 VC6.0 里跑通对话框程序、但被状态标志绕晕的人。你手上如果有一份能点出数字的对话框计算器,就可以跟着改;没有也可以先用四个状态把逻辑画在纸上,再回填到按钮入口。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具里的状态机设计:四个状态与四类事件怎么切
2.1 先把状态定死:ST_EMPTY、ST_NUM1、ST_OP、ST_NUM2
计算器看起来是“按钮 → 显示 → 计算”,实际是一个状态流转系统。一个够用的状态机只需要四个状态:ST_EMPTY 表示初始化后还没输入;ST_NUM1 表示正在输入第一个操作数;ST_OP 表示已经按下运算符,等待第二个操作数;ST_NUM2 表示正在输入第二个操作数。事件也只需要分四类:数字键、运算符键、等号键、清除键。
这里的关键不是状态数量多,而是每个状态只回答“现在能不能接收某类事件”。比如 ST_EMPTY 收到数字键,动作是替换显示并进入 ST_NUM1;ST_OP 收到数字键,动作同样是替换显示,但进入 ST_NUM2。看起来都是“显示一个数字”,落到的状态不同,后续按等号时是否计算就完全不同。
cpp复制enum CalcState { ST_EMPTY, ST_NUM1, ST_OP, ST_NUM2 };
这段枚举来自工程里的对话框类成员定义,四个值对应上面四个阶段。实际编码时把 m_state 作为 CJisuanDlg 的成员变量,初值设为 ST_EMPTY。不要再用 m_bFirstNum、m_bHasOperator 这类布尔标志去组合状态,否则状态组合一多,等号、运算符、清除键之间的路径必然漏。
2.2 迁移表比布尔标志可靠:每个事件只回答“当前状态去哪”
状态机落地前先把迁移表写出来,比直接改按钮函数稳得多。下面这张表是计算器最小可用版本,横轴是当前状态,纵轴是事件类型。表里的“显示动作”和“新状态”就是后面每个事件处理函数要照抄的逻辑。
| 当前状态 | 数字键 | 运算符键 | 等号键 | 清除键 |
|---|---|---|---|---|
| ST_EMPTY | 替换显示,转 ST_NUM1 | 忽略或只记录运算符 | 不计算 | 显示归零,留在 ST_EMPTY |
| ST_NUM1 | 追加数字,留在 ST_NUM1 | 记录运算符,转 ST_OP | 不计算 | 显示归零,转 ST_EMPTY |
| ST_OP | 替换显示,转 ST_NUM2 | 覆盖运算符,留在 ST_OP | 不计算 | 显示归零,转 ST_EMPTY |
| ST_NUM2 | 追加数字,留在 ST_NUM2 | 记录新运算符,转 ST_OP | 计算,结果转 ST_NUM1 | 显示归零,转 ST_EMPTY |
这张表有两个容易忽略的细节。第一,运算符键在 ST_NUM1 里的动作是“记录运算符,转 ST_OP”,不是立刻计算;在 ST_OP 里则是“覆盖运算符,留在 ST_OP”,避免用户连按加号时把状态打乱。第二,等号键只在 ST_NUM2 里真正计算,算完把状态切回 ST_NUM1,这样结果可以继续参与下一次运算,而不会每次按等号都重复算一遍。
2.3 选型理由:为什么不在按钮函数里直接算
直接在按钮函数里算,最省事,也最容易翻车。按钮函数只知道“我被点了”,不知道当前处于哪个阶段,于是只能靠一堆标志去猜:有没有输入第一个数、有没有按运算符、显示区里是不是结果。标志一多,代码里就会出现“这个分支先判断 A 再判断 B,那个分支先判断 B 再判断 A”的补丁,最后连自己都不敢改。
状态机的价值是把“当前处于哪个阶段”收敛成一个枚举值。每个按钮处理函数只做两件事:根据 m_state 决定动作,动作完成后更新 m_state。它不需要回溯前几次点击发生了什么,也不会因为新增一个键盘入口就把原有按钮逻辑冲乱。后面接 PreTranslateMessage 时,键盘和鼠标只是两个输入设备,最终都调用同一套事件入口,计算逻辑不再被界面代码裹挟。
从可测试角度看,状态机还能用事件序列验证。比如先点数字 1、再点数字 2、再点加号、再点数字 3、最后按等号,状态应该走 ST_EMPTY → ST_NUM1 → ST_NUM1 → ST_OP → ST_NUM2 → ST_NUM1。这条序列在迁移表上能逐格核对,而布尔标志版本只能靠人脑模拟,漏一条路径就可能在等号上多算一次。
3. 代码开发工具落地 OnDigit:一次按键如何决定替换还是追加
3.1 OnDigit 的完整入口:switch 只认当前状态
数字键是所有输入里最频繁的事件,先把 OnDigit 写成统一入口,后面键盘扩展才有地方转发。下面这段代码是材料里给出的核心分发函数,数字键不区分来源,鼠标按钮和键盘字符都调用它。
cpp复制enum CalcState { ST_EMPTY, ST_NUM1, ST_OP, ST_NUM2 };
// 数字键事件的统一入口
void CJisuanDlg::OnDigit(int nDigit)
{
switch (m_state)
{
case ST_EMPTY:
case ST_OP:
// 新输入:替换显示区
m_strDisplay.Format(_T("%d"), nDigit);
m_state = (m_state == ST_OP) ? ST_NUM2 : ST_NUM1;
break;
case ST_NUM1:
case ST_NUM2:
// 连续输入:追加数字
if (m_strDisplay == _T("0"))
m_strDisplay.Format(_T("%d"), nDigit);
else
m_strDisplay.AppendFormat(_T("%d"), nDigit);
break;
}
SetDlgItemText(IDC_EDIT_DISPLAY, m_strDisplay);
}
这段代码的逻辑说明如下。nDigit 是 0 到 9 的整数值,由按钮或键盘换算后传入。m_strDisplay 是对话框类里保存显示字符串的成员,IDC_EDIT_DISPLAY 是显示控件的资源 ID。进入 ST_EMPTY 或 ST_OP 时,说明当前还没有第一个操作数,或者刚按完运算符等待第二个操作数,所以动作是替换显示区,而不是往旧字符串后面追加;随后 ST_EMPTY 转到 ST_NUM1,ST_OP 转到 ST_NUM2。
进入 ST_NUM1 或 ST_NUM2 时,说明正在连续输入同一个操作数,动作是追加数字。这里有一个边界:如果显示区当前是 "0",直接追加会变成 "00" 或 "01",所以代码先用 if (m_strDisplay == _T("0")) 做替换,否则才调用 AppendFormat。最后统一调用 SetDlgItemText 刷新控件,保证每次按键后界面和成员变量一致。
3.2 运算符与等号事件怎么接:最小分发骨架
数字入口通了之后,运算符和等号不能各自在按钮函数里写一套计算。按迁移表的约定,运算符事件只做“记录运算符,把状态切到 ST_OP”,等号事件只在 ST_NUM2 下计算,算完把状态切回 ST_NUM1。下面是一个最小分发骨架,计算部分沿用工程里已有的四则运算函数,不在这里重新发明算法。
cpp复制void CJisuanDlg::OnOperator(int op)
{
// 只记录运算符,不急着计算
m_nOp = op;
m_state = ST_OP;
}
void CJisuanDlg::OnEqual()
{
// 没有第二个操作数时按等号不计算
if (m_state != ST_NUM2)
return;
// 这里调用工程里已有的四则运算函数,
// 用 m_nOp 决定加、减、乘、除,结果写回 m_strDisplay
m_state = ST_NUM1;
SetDlgItemText(IDC_EDIT_DISPLAY, m_strDisplay);
}
OnOperator 的参数 op 是运算符枚举或整型编码,调用方负责把按钮和键盘上的加、减、乘、除映射成同一个值。m_nOp 是对话框类的成员,保存当前待执行的运算符。OnEqual 里的 if (m_state != ST_NUM2) return; 是防多算的第一道闸门:用户还没输入第二个操作数就按等号,状态不是 ST_NUM2,直接返回,不进入计算分支。
这段骨架不负责具体加减乘除,因为计算函数属于原工程已有的业务逻辑。重构时只把“何时算、算完状态去哪”收进状态机,算法本身不要顺手重写。这样改完之后,按钮的 OnEqual 和键盘回车最终都调用同一个 OnEqual,不会出现鼠标算一次、键盘又算一次的岔路。
3.3 连续输入的前导零和显示刷新
数字入口里最值得盯的是前导零。代码里 if (m_strDisplay == _T("0")) 只处理了“显示区正好是 0”的情况,这已经覆盖了初始状态和清除后的状态。如果显示区是 "10",再按 0,AppendFormat 会得到 "100",这是正常追加;如果显示区是 "0",再按 1,替换后得到 "1",不会变成 "01"。这条判断放在 ST_NUM1 和 ST_NUM2 共用的追加分支里,两个操作数输入阶段都能受益。
显示刷新则统一放在 OnDigit 末尾,而不是每个 case 里各写一次 SetDlgItemText。这样后续加退格、加清除时,只要它们也走统一入口,就不会出现“成员变量改了但控件没刷新”的黑匣子现象。下面这张按键序列表可以用来对照验证:
| 操作序列 | 预期状态 | 显示区 |
|---|---|---|
| 初始 | ST_EMPTY | 0 |
| 按 1 | ST_NUM1 | 1 |
| 按 2 | ST_NUM1 | 12 |
| 按 + | ST_OP | 12 |
| 按 3 | ST_NUM2 | 3 |
| 按 = | ST_NUM1 | 计算结果 |
如果按 3 之后显示区仍然停在 12,说明 ST_OP 分支没有把状态切到 ST_NUM2,或者数字入口没有走到替换分支。排查时先看 m_state 的值,再看 m_strDisplay 的内容,最后看控件有没有刷新,三步能定位到具体分支。
4. 代码开发工具里的键盘扩展:PreTranslateMessage 的映射与消费
4.1 重写 PreTranslateMessage:把 WM_KEYDOWN 转成统一入口
鼠标按钮跑通之后,键盘扩展的性价比很高。在对话框类里重写虚函数 PreTranslateMessage,拦截按键消息并转发到统一入口,计算器就能从“只能鼠标点”变成“键盘盲打也流畅”。材料给出的实现如下。
cpp复制BOOL CJisuanDlg::PreTranslateMessage(MSG* pMsg)
{
if (pMsg->message == WM_KEYDOWN)
{
switch (pMsg->wParam)
{
case '0': case '1': case '2': case '3': case '4':
case '5': case '6': case '7': case '8': case '9':
OnDigit(pMsg->wParam - '0');
return TRUE;
case '+': OnOperator(OP_ADD); return TRUE;
case VK_RETURN: OnEqual(); return TRUE;
case VK_BACK: OnBackspace(); return TRUE;
}
}
return CDialog::PreTranslateMessage(pMsg);
}
这段代码的逻辑说明:pMsg->message == WM_KEYDOWN 只处理按下消息,不处理抬起和字符重复消息。数字键用字符字面量 '0' 到 '9' 判断,pMsg->wParam - '0' 把 Windows 消息里的字符码换算成 0 到 9 的整数,再传给 OnDigit。'+' 直接映射到 OnOperator(OP_ADD),回车 VK_RETURN 映射到 OnEqual,退格 VK_BACK 映射到 OnBackspace。每个命中分支都返回 TRUE,表示消息已被消费,不再交给对话框默认处理。
参数上要注意,pMsg->wParam 在 WM_KEYDOWN 里是虚拟键码或字符码,数字键的字符码和 '0' 到 '9' 的字面量可以直接比较;功能键则必须用 VK_RETURN、VK_BACK 这类虚拟键常量,不能写成 '\r' 或 '\b' 去碰运气。未命中的按键最后交给 CDialog::PreTranslateMessage(pMsg),保证对话框其他默认行为不被吞掉。
4.2 键盘映射表:字符键、虚拟键和消费规则
键盘扩展最容易翻车的地方不是映射写错,而是返回值写错。下面这张表把常用键的映射和消费规则固定下来,改代码时照着核对。
| 按键 | 消息参数 | 调用入口 | 返回值 |
|---|---|---|---|
| 0 到 9 | WM_KEYDOWN,wParam 为字符码 |
OnDigit(wParam - '0') |
TRUE |
| + | WM_KEYDOWN,wParam 为 '+' |
OnOperator(OP_ADD) |
TRUE |
| 回车 | WM_KEYDOWN,wParam 为 VK_RETURN |
OnEqual() |
TRUE |
| 退格 | WM_KEYDOWN,wParam 为 VK_BACK |
OnBackspace() |
TRUE |
| 其他键 | WM_KEYDOWN |
不处理 | 交给基类 |
return TRUE 不是可有可无的装饰。材料里明确写了:函数返回 TRUE 表示消息已被消费,对话框不会发出无按键响应的提示音。如果数字键命中后忘了返回,消息继续往下走,对话框可能发出提示音,用户会以为按键没生效,实际上显示区已经变了。排查这类问题时,先看命中分支有没有 return TRUE,再看 OnDigit 内部有没有刷新控件。
4.3 退格与回车的最小接法
退格键在材料里只提到“退格映射到删除”,具体实现要接进现有显示字符串。最小做法是从显示字符串尾部删一个字符,空串回 "0",然后刷新控件。下面这段代码可以直接放进对话框类,状态处理按当前输入阶段做最小复位。
cpp复制void CJisuanDlg::OnBackspace()
{
if (!m_strDisplay.IsEmpty())
m_strDisplay = m_strDisplay.Left(m_strDisplay.GetLength() - 1);
if (m_strDisplay.IsEmpty())
m_strDisplay = _T("0");
SetDlgItemText(IDC_EDIT_DISPLAY, m_strDisplay);
}
CString::Left 按长度截取左侧子串,GetLength() 返回当前字符数,减一就是去掉最后一个字符。删到空串时回填 "0",避免显示区变成空白。如果当前处于 ST_NUM1 或 ST_NUM2,删到空之后可以把 m_state 切回 ST_EMPTY,这样再按数字会走替换分支,不会在空串上追加。回车键不需要单独写删除逻辑,它已经在 PreTranslateMessage 里转到 OnEqual,和鼠标等号共用同一套状态判断。
5. 代码开发工具避坑:多算一次、提示音和漏路径的排查
5.1 多算一次与状态漏路径:布尔标志的坑
现象:按下等号后,结果区显示的值像是又参与了一次运算,或者连续按两次等号时第二次仍然在算。原因:用布尔标志表达“当前处于哪个阶段”,等号事件没有按状态判断,计算分支被重复进入。解决:把等号处理收进状态机,只在 m_state == ST_NUM2 时计算,计算完立刻把状态切回 ST_NUM1;ST_OP、ST_EMPTY、ST_NUM1 下按等号直接返回。这样等号第一次有效,第二次因为状态已经不是 ST_NUM2,不会重复计算。
这类 bug 在按钮版本里很难靠加 if 补干净,因为每次新增键盘入口、清除入口,都要再补一遍标志判断。状态机的做法是把判断集中到迁移表,按钮和键盘都走同一个入口,漏路径的概率会低很多。
5.2 键盘提示音与消息吞掉:PreTranslateMessage 的返回值
现象:按数字键时显示区已经更新,但系统仍然发出“叮”的提示音,或者按回车没有反应。原因:PreTranslateMessage 命中按键后没有返回 TRUE,消息继续交给对话框默认处理;另一种情况是命中分支写错,回车没有映射到 OnEqual。解决:每个命中分支末尾统一 return TRUE,未命中再 return CDialog::PreTranslateMessage(pMsg);回车用 VK_RETURN 判断,不要用字符 '\r' 猜。
改完返回值后,用键盘盲打一遍:数字、加号、数字、回车,看显示区是否按迁移表走。如果数字有提示音但显示正常,优先查返回值;如果回车完全没反应,优先查 VK_RETURN 分支有没有被前面的 case 截走。
5.3 前导零和连续运算符:输入边界
现象:连续按 0 后显示区出现 "00",或者输入第一个数后连按两个运算符,状态乱掉。原因:追加分支没有判断当前显示是否为 "0";运算符事件没有统一入口,按钮里直接改了状态。解决:追加前先判断 m_strDisplay == _T("0"),成立就替换,不成立才 AppendFormat;运算符统一走 OnOperator,在 ST_NUM1 里记录并转 ST_OP,在 ST_OP 里覆盖运算符并留在 ST_OP。
前导零看起来是小问题,但它会影响后续字符串转数值。显示区是 "01" 时,转换函数可能仍能算出 1,但显示和用户预期不一致,演示时很扎眼。把判断放在 OnDigit 的追加分支里,鼠标和键盘都覆盖到。
5.4 清除键与状态复位:别只清显示
现象:按清除后显示区归零,但再按等号仍然触发计算,或者旧运算符还留着。原因:清除事件只调了 SetDlgItemText 把显示改成 "0",没有复位 m_state、m_nOp 和操作数缓存。解决:清除事件里做三件事——显示归零、m_state = ST_EMPTY、清掉当前运算符和操作数缓存;如果工程里有 m_nOp,把它置为一个无效值或默认值,确保下一次等号不会拿旧运算符去算。
清除键是状态机里最容易被写成“只清界面”的入口。界面清了、状态没清,后面所有按键都会在旧状态上继续走,表现出来就是“清除了但没完全清除”。把清除当成一次完整的状态复位,比在每个按钮里补判断更省心。
6. 代码开发工具进阶:把计算逻辑从对话框里剥出来验证
6.1 用事件序列验证状态机
状态机写完不要只靠手点。准备几条事件序列,逐条对照迁移表,能提前抓到漏路径。下面这张表是我常用的最小验证集:
| 事件序列 | 预期状态 | 预期显示 |
|---|---|---|
| 1, 2, +, 3, = | ST_NUM1 | 15 |
| 1, +, 2, +, 3, = | ST_NUM1 | 3 或按工程运算优先级结果 |
| 0, 0, 1 | ST_NUM1 | 1 |
