学 Win32 的人大概都有这么一段经历:前面几章还在折腾消息框、画线、点鼠标,个个都觉得自己会做窗口了;到了第 4 章,突然被一个 SysMets1 糊了一脸——原来前面那些都是热身,滚动条一进来,才算是真正开始做交互程序。
SysMets1 是《Windows 程序设计》里那个经典的"系统指标展示器",全称大概是 System Metrics Display 一号工程。它干的事很简单:把 Windows 的系统指标(屏幕宽高、滚动条宽度、标题栏高度、光标尺寸、图标尺寸这些)一条条列在窗口里,并且同时用垂直滚动条和水平滚动条让用户来回翻看。数据源不需要数据库,不需要网络,完全靠一个 GetSystemMetrics 函数就能拿到;界面不需要花哨控件,两个滚动条加若干 TextOut 就撑起了整个程序。
但越是简单的目标,越能暴露基本功。这个案例把消息处理、字体度量、滚动条三套机制缝在了一起,是典型的"看着不起眼,写起来全是细节"。这篇文章把我自己从读源码、手敲、编译到踩坑的完整过程捋一遍,重点讲清楚滚动条那套消息是怎么转起来的,以及哪些地方教材没明说但实战一定会遇到。
1. SysMets1 解决了什么问题:从"画窗口"跨到"做程序"的分水岭
1.1 为什么第 4 章要用"系统指标"当案例
如果你手边有 Windows SDK 文档,搜 GetSystemMetrics 会看到一个长长列表:SM_CXSCREEN 是屏幕宽度,SM_CYSCREEN 是屏幕高度,SM_CXVSCROLL 是垂直滚动条宽度,SM_CYHSCROLL 是水平滚动条高度,SM_CYCAPTION 是标题栏高度,SM_CXCURSOR 是鼠标光标宽度,SM_CYICON 是图标高度……这些都是操作系统在启动时根据当前显示模式、主题、字体平滑策略等计算好的"系统级参数"。
选择它当综合案例,我认为有三个很现实的原因。
第一,数据来源零依赖。GetSystemMetrics 是 Win32 API 里最"白送"的函数之一,不需要初始化设备、不需要打开文件、不需要网络请求,任何时候调用都会立刻返回结果。这让初学者可以把全部注意力放在界面逻辑上,不会被业务数据干扰。
第二,天然适合滚动展示。系统指标一个屏幕通常装不下,比如屏幕分辨率、滚动条尺寸、边框尺寸、光标尺寸、图标尺寸、窗口框架尺寸、菜单高度、消息框尺寸……Windows 2000 之后又加入了 DPI 相关、触摸相关的指标。数据行数超过窗口可视区域,正好逼着你必须处理滚动条。
第三,结果能即时验证。程序跑起来,上面显示的每一个值,你都可以用系统设置或者 Spy++ 之类的工具对照检查。比如显示"Screen width in pixels: 1920",你一看自己的分辨率确实是 1920,这种"程序里的数字和现实一一对应"的反馈,对建立信心特别有帮助。
SysMets1 把三列信息组织成一张表:第一列是指标常量名,比如 SM_CXSCREEN;第二列是英文描述,比如 "Screen width in pixels";第三列是实际数值,比如 1920。窗口底部没有状态栏,顶部没有工具栏,就是干干净净的滚动区域。
1.2 程序整体行为拆解:双滚动条加三列文本
这个程序最容易被忽略的地方是:它同时有垂直和水平两个滚动条。
垂直滚动条负责按"行"滚动,每滚动一行就是跳一个系统指标的记录。这样 20 多条数据,窗口哪怕只有巴掌大,也能全部翻到。水平滚动条负责按"字符"滚动,因为第三列说明文字很长,如果窗口宽度不够,水平拖动可以看到被截断的部分。
两个滚动条对应两套完全独立的滚动范围:垂直方向的范围是 0 到 NUMLINES - 1(NUMLINES 是数据行数减 1),水平方向的范围是 0 到某个最大字符跨度。这个"一个程序里出现两套滚动范围"的设计,其实是在告诉你:滚动条不是窗口的附属品,它就是一个独立控件,你想让它滚什么、滚多宽,完全由你定义。
我刚开始学的时候,想当然地以为滚动条只能滚"一整屏"或者"一整行"。实际上 Win32 的滚动条消息给了一套更细的粒度:SB_LINEUP / SB_LINEDOWN 是单步滚动,SB_PAGEUP / SB_PAGEDOWN 是整页翻滚,SB_THUMBTRACK 是拖动滚动框时连续触发。这四个维度组合起来,体验上已经非常接近现代 UI。
SysMets1 的窗口过程里,WM_VSCROLL 和 WM_HSCROLL 各写一段 switch,用 GetScrollPos 拿到当前位置,根据滚动请求计算出新位置,再用 SetScrollPos 写回去,最后 InvalidateRect 触发重绘。整个过程没有花哨的技巧,但它是后来所有滚动交互(键盘滚动、鼠标滚轮、触摸滚动)的地基。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 亲手过一遍核心代码:消息循环之外的三个关键函数
2.1 WM_CREATE 里的字体度量与滚动条初始化
SysMets1 在 WM_CREATE 里做的事情,决定了后面所有绘制坐标怎么算。
首先是取设备上下文,调用 GetTextMetrics 拿到当前字体的度量结构 TEXTMETRIC。这个结构里最关键的是三个字段:
tmAveCharWidth:字体小写字符的平均宽度,赋值给cxChar,用于计算水平坐标。tmHeight + tmExternalLeading:行高,赋值给cyChar,用于垂直方向每行的高度。tmPitchAndFamily & 1:判断字体是否比例字体。如果是比例字体,大写字母宽度和平均宽度不同,需要单独算一个cxCaps = 3 * cxChar / 2;如果是不等宽字体,cxCaps = cxChar。
这里 cxCaps 是个很容易被新手忽略的细节。SysMets1 的第二列是英文描述,第三列是数字,如果直接用 cxChar 去做三列之间的水平偏移,比例字体下大写字母串会跟后面的数字粘在一起。作者用 22 * cxCaps 和 40 * cxChar 这种粗略比例来分栏,目的就是让三列视觉上基本对齐。放到今天看,这个算法并不精致,但在 GDI 纯文本绘制的年代,已经是兼顾简洁和效果的实用方案。
拿到字体度量之后,程序创建了水平滚动条和垂直滚动条。教材里用的是老式 SetScrollRange:
cpp复制SetScrollRange(hwnd, SB_VERT, 0, NUMLINES - 1, FALSE);
SetScrollPos(hwnd, SB_VERT, 0, TRUE);
SetScrollRange(hwnd, SB_HORZ, 0, MAX_WIDTH / cxChar, FALSE);
SetScrollPos(hwnd, SB_HORZ, 0, TRUE);
SB_VERT 和 SB_HORZ 分别指定操作垂直还是水平滚动条。第三、四个参数是滚动范围的最小值和最大值。最后一个 bRedraw 先传 FALSE,等 SetScrollPos 设置好具体位置之后再统一重绘,避免滚动条闪两下。
注意,这套老 API 只设置了范围,没有设置"每页大小"。结果就是:滚动条虽然能拖动,但滚动框的尺寸不会随窗口大小变化,看起来永远是一个小方块。这是 SysMets1 的一个时代印记,也是后面要讲的新坑。
2.2 WM_PAINT 里的三列对齐排版
窗口需要刷新时,WM_PAINT 会走到一段核心绘制逻辑。简化后的代码大概是这样的:
cpp复制case WM_PAINT:
BeginPaint(hwnd, &ps);
SetTextAlign(hdc, TA_LEFT | TA_TOP);
iVscrollPos = GetScrollPos(hwnd, SB_VERT);
iHscrollPos = GetScrollPos(hwnd, SB_HORZ);
for (i = 0; i < NUMLINES; i++)
{
x = cxChar + 3 - iHscrollPos * cxChar;
y = cyChar * (i - iVscrollPos);
TextOut(hdc, x, y,
sysmetrics[i].szLabel,
lstrlen(sysmetrics[i].szLabel));
TextOut(hdc, x + 22 * cxCaps, y,
sysmetrics[i].szDesc,
lstrlen(sysmetrics[i].szDesc));
SetTextAlign(hdc, TA_RIGHT | TA_TOP);
TextOut(hdc, x + 22 * cxCaps + 40 * cxChar, y,
szBuffer, wsprintf(szBuffer, TEXT("%5d"),
GetSystemMetrics(sysmetrics[i].nIndex)));
SetTextAlign(hdc, TA_LEFT | TA_TOP);
}
EndPaint(hwnd, &ps);
return 0;
这里有几个非常值得展开的点。
第一,为什么先 GetScrollPos 再画? 因为滚动位置是窗口状态的一部分,绘制时必须以"当前此刻"的滚动位置为准。如果你只画传给 WM_PAINT 时保存的旧值,拖动滚动条后画面就不会正确更新。SysMets1 在每次滚动消息处理里已经 SetScrollPos 了,这里再读一次是双保险,也是后来很多 UI 框架"绘制前先同步状态"思路的雏形。
第二,水平偏移公式 x = cxChar + 3 - iHscrollPos * cxChar。 当水平滚动位置为 0 时,第一列从 cxChar + 3 开始画,留出左边距;每向右滚一个单位,整个文本就向左移一个字符宽度。这个负数偏移是水平滚动的核心,一旦理解它,你再看任何横向滚动的表格代码都会觉得似曾相识。
第三,SetTextAlign 来回切换。 前两列用左对齐,第三列数字改成右对齐,这样数字的个位都在同一竖线上,看起来非常整齐。画完第三个 TextOut 之后再立刻改回 TA_LEFT | TA_TOP,否则下一行前两列也会变成右对齐,整个布局就乱了。这种"临时改对齐方式、用完马上还原"的写法,是 GDI 文本绘制的常见套路。
2.3 WM_SIZE 与滚动消息的联动
WM_SIZE 消息里有一个 OnSize 函数,作用是重新计算滚动条每页显示多少行,从而让滚动框的长度反映窗口可视区域的大小。教材版本用了 SCROLLINFO 结构:
cpp复制void OnSize(HWND hwnd, int cxClient, int cyClient)
{
SCROLLINFO si;
si.cbSize = sizeof(si);
si.fMask = SIF_RANGE | SIF_PAGE;
si.nMin = 0;
si.nMax = NUMLINES - 1;
si.nPage = cyClient / cyChar;
SetScrollInfo(hwnd, SB_VERT, &si, TRUE);
si.fMask = SIF_RANGE | SIF_PAGE;
si.nMin = 0;
si.nMax = MAX_WIDTH / cxChar;
si.nPage = cxClient / cxChar;
SetScrollInfo(hwnd, SB_HORZ, &si, TRUE);
}
nPage 表示滚动条一页能覆盖多少单位。垂直方向,窗口客户区高度 cyClient 除以每行高度 cyChar,就是当前可见的行数。这个值传给滚动条后,滚动框的长度会随窗口缩放自动变化,拖起来的手感跟现代程序基本一致。
WM_VSCROLL 的处理是这章的"题眼",我直接贴简化版:
cpp复制case WM_VSCROLL:
iVscrollPos = GetScrollPos(hwnd, SB_VERT);
switch (LOWORD(wParam))
{
case SB_TOP: iVscrollPos = 0; break;
case SB_BOTTOM: iVscrollPos = NUMLINES - 1; break;
case SB_LINEUP: iVscrollPos -= 1; break;
case SB_LINEDOWN: iVscrollPos += 1; break;
case SB_PAGEUP: iVscrollPos -= cyClient / cyChar; break;
case SB_PAGEDOWN: iVscrollPos += cyClient / cyChar; break;
case SB_THUMBTRACK: iVscrollPos = HIWORD(wParam); break;
}
iVscrollPos = max(0, min(NUMLINES - 1, iVscrollPos));
if (iVscrollPos != GetScrollPos(hwnd, SB_VERT))
{
SetScrollPos(hwnd, SB_VERT, iVscrollPos, TRUE);
InvalidateRect(hwnd, NULL, TRUE);
}
return 0;
有几点要记住。
第一,滚动请求类型存在 LOWORD(wParam),而拖动滚动框时的位置存在 HIWORD(wParam),新手最容易写反。
第二,SB_THUMBTRACK 和 SB_THUMBPOSITION 的区别:SB_THUMBTRACK 是拖动过程中持续触发,SB_THUMBPOSITION 是拖动结束后触发一次。SysMets1 只处理 SB_THUMBTRACK,这样拖动时画面能实时跟随。如果你两个都想支持,可以在两个 case 里写一样的赋值。不过要注意,如果只处理 SB_THUMBPOSITION,拖动过程画面不会动,体验很差。
第三,边界钳制非常重要。用户按住滚动条下箭头不松,或者直接拖动滚动框到极端位置,计算出来的 iVscrollPos 可能越界。用 max(0, min(NUMLINES - 1, iVscrollPos)) 把值夹在合法范围里,否则绘制时行号会变成负数,导致花屏。
第四,加了一个 if (iVscrollPos != GetScrollPos(...)) 判断,意思是"位置真的变了才重绘"。这是个性能上的小优化,也是很多生产代码里的习惯写法,避免每次收到滚动消息无论有没有变化都做无效的 InvalidateRect。
3. 滚动条设计的经验边界:为什么老代码里藏着新坑
3.1 SetScrollRange 与 SetScrollInfo 的差异,以及拖动滚动框的死区问题
教材里 WM_CREATE 用 SetScrollRange 初始化范围,后面的 WM_SIZE 又用 SetScrollInfo 更新。这种混用其实有历史原因:早期 Windows 只有 SetScrollRange,后来才引入 SetScrollInfo,可以提供 SIF_PAGE 这样的扩展信息。但如果你在实际项目里新写滚动逻辑,我的建议是从第一行代码开始就用 SetScrollInfo,别碰 SetScrollRange。
原因很简单:SetScrollRange 不知道"每页大小",所以滚动框的尺寸永远是固定的,不会随窗口变化。用户把窗口拉大,滚动框还是那么小,跟内容完全不成比例。而 SetScrollInfo 通过 SIF_DISABLENOSCROLL、SIF_PAGE、SIF_POS、SIF_RANGE 这些掩码,可以一次性把范围、当前值和页大小全部设置好。
还有一个非常隐蔽的坑,就是 SIF_DISABLENOSCROLL。如果你在初始化时设置了它,内容没超出可视区域时,滚动条会变成灰色禁用状态;如果不设置,滚动条会直接消失。SysMets1 用旧 API,默认行为是"不需要滚动时滚动条消失"。很多初学者看到程序里滚动条时隐时现,以为是 bug,其实这是滚动条控件的原始行为。你自己实现时,要根据产品需求决定到底用哪种。
另外,拖动滚动框的过程中还有一个"死区"问题。如果你只处理 SB_THUMBTRACK,那么鼠标在滚动框上按下后快速拖出滚动条区域,滚动框会停住不跟手。正确的做法是同时处理 SB_THUMBTRACK 和 SB_THUMBPOSITION,或者至少在你的拖动逻辑里记录上次滚动位置,防止消息丢失导致状态错乱。教材里只写 SB_THUMBTRACK,是因为当时的滚动条消息相对可靠,但现代 Windows 的合成器、触控板手势会引入更复杂的消息序列,实战里建议把 SB_THUMBTRACK 当成主路径,SB_THUMBPOSITION 当成兜底。
3.2 滚动后的重绘策略:InvalidateRect 与 UpdateWindow 的配合
我在前文提到,滚动位置更新后要调用 InvalidateRect。但这样做有一个隐含问题:InvalidateRect 只是把窗口标记为"待重绘",实际的 WM_PAINT 是在消息队列空闲时才会发出。如果你连续收到多个滚动消息,最后可能只合并成一次重绘,中间的滚动位置就"跳"过去了。
解决方法是看场景。SysMets1 这类轻量绘制,内容量不大,合并不合并影响不大。但如果你是一个文本编辑器、图表控件,滚动时必须保证用户看到的每一帧都跟滚动位置同步,那就应该在 SetScrollPos 之后紧接着调用 UpdateWindow(hwnd),强制立刻发送 WM_PAINT。当然,UpdateWindow 也不建议滥用,它会把绘制变成同步操作,如果每帧绘制很重,反而会卡界面。我自己的习惯是:滚动一帧绘制成本低于 5ms 的用 InvalidateRect 就够了;如果绘制超过 10ms,那就别硬画,考虑后台缓冲和增量绘制。
还有一点,InvalidateRect(hwnd, NULL, TRUE) 里的第三个参数 bErase 为 TRUE,表示重绘前先擦背景。如果不传 TRUE,背景会残留上一帧的文本残影,滚动时非常难看。但传了 TRUE 又会有闪烁,因为窗口先被擦成背景色,再慢慢画出文字。这个问题在 SysMets1 里不明显,窗口小、内容少;等你做全屏绘图时,闪烁会逼你用双缓冲。到那时候,WM_ERASEBKGND 直接返回 TRUE、BitBlt 整块贴图这些套路就该登场了。
3.3 字体度量的隐藏坑:对话框单位与 GetTextMetrics 之争
SysMets1 里出现了一个容易让人误会的点:代码中取字体度量是通过 GetDC + GetTextMetrics,但早期版本里也出现过用 GetDialogBaseUnits 的做法。这两个函数拿到的结果在默认系统字体下非常接近,但差别很关键。
GetTextMetrics 返回的是指定设备上下文中当前字体的度量。如果窗口类注册时用了 LoadCursor、CreateWindow 默认的系统字体,那么 GetTextMetrics 拿到的就是系统 UI 字体的行高和字符宽。GetDialogBaseUnits 返回的则是一种基于 16 位 Windows 对话框标准的"对话框单位",它不一定跟窗口实际使用的字体完全一致。
在新版的 Windows 10 / 11 上,DPI 缩放会把这件事变得更复杂。如果你的程序没有声明 DPI 感知,系统会对字体做虚拟化缩放,GetTextMetrics 取到的可能是被缩放过的值,而你用这个值去计算滚动范围和绘制坐标,在高分屏下会出现文字忽大忽小、行距不对的问题。我在 150% 缩放的笔记本上跑 SysMets1,发现行高确实会偏大,滚动范围也就跟着多了几行。
所以我的建议是:如果你只是复现教材,用 GetTextMetrics 没问题;如果你要做成产品,先研究 SetProcessDpiAwarenessContext 和 PerMonitorV2,确保 GetTextMetrics 拿到的是物理像素下的真实字体度量,再去算滚动范围。否则你会在高分屏上遇到"滚动范围永远比内容多一截"的诡异情况。
4. 从源码到可运行文件:编译脚本与实测异常
4.1 两条编译路线:Visual Studio 命令行与 MinGW
SysMets1 是典型的 Win32 程序,入口是 WinMain,子系统必须是 Windows(GUI)。不管用哪套工具链,只要把 Windows 库链接进来就行。
用 Visual Studio 的开发人员命令提示符,最朴素的编译命令是这样:
code复制cl SysMets1.c user32.lib gdi32.lib
默认情况下 cl 会根据入口点自动判断子系统,检测到 WinMain 就会链接 /SUBSYSTEM:WINDOWS。user32.lib 提供 GetSystemMetrics、SetScrollInfo、TextOut 这些核心 API,gdi32.lib 提供设备上下文和文本绘制相关函数。如果你的代码里还用了 MessageBox,它也在 user32 里。这里不需要显式写 kernel32.lib,因为 C 运行时库会默认带上。
如果你用的是 MinGW-w64 环境,命令也差不多:
code复制gcc -o SysMets1.exe SysMets1.c -mwindows -luser32 -lgdi32
-mwindows 告诉链接器这个程序是 GUI 子系统,不会弹出黑色控制台窗口。我实测下来,两种方式都能直接跑起来。
还有一点值得提:SysMets1 源码里大量使用了 TEXT() 宏和 TCHAR 类型。如果你在 Visual Studio 里默认工程是 Unicode,编译后字符串是 UTF-16;如果命令行手敲时没定义 UNICODE,它就走 ANSI。两种方式跑出来的效果没区别,但如果你混合使用两种字符集编程,字符串拼接时容易出 LNK 或者编译报错。我的建议是:现代 Windows 程序直接 #define UNICODE,所有字符串带 L 前缀,省去一堆编码转换的麻烦。
4.2 双击报"不是有效的 Win32 应用程序":我实测遇到的几种原因
这个报错堪称 Win32 初学者最经典的玄学问题。我拿自己编译的 SysMets1.exe 和网上下的旧版示例排查过,归纳下来无非四种情况。
第一种,文件确实不是 PE 格式。比如你把源码文件后缀直接改名为 .exe,或者下载时浏览器把页面存成了 .txt。用十六进制编辑器打开看文件头,正常的 PE 文件开头是 MZ,再往后隔一段是 PE 标志。如果开头是文本或者别的什么,那根本不是可执行文件。用 dumpbin /headers SysMets1.exe 或者 MinGW 下的 objdump -f SysMets1.exe 都能快速验证。
第二种,架构不匹配。64 位 Windows 能运行 32 位程序,但反过来不行。如果你用 64 位工具链编译却生成了 64 位 PE,拿到 32 位 Windows 上双击就会报这个错。SysMets1 这种教学程序一般是 32 位编译,在今天的 64 位 Windows 上完全没问题;但如果你设置了 /MACHINE:X64,又想扔给 XP 32 位虚拟机跑,那必然报错。
第三种,缺少运行库依赖。SysMets1 只依赖系统 DLL,不依赖额外的 C 运行时,所以基本不会触发这个;但如果你用 Debug 模式编译,链接了 MSVCRTxxxD.dll,而目标机器上没有对应的 VC 运行库,也会出现"不是有效的 Win32 应用程序"或者直接提示缺少 DLL。解决方法是要么用 Release 编译并静态链接运行时,要么把运行库一起带过去。
第四种,最容易被忽略的:压缩工具或杀毒软件改了文件头。文件在传输、下载、解压过程中被第三方工具处理坏了,PE 头校验失败,Windows 加载器直接拒认。遇到这种,重新编译一遍,关闭可疑的实时防护,再试一次。
我自己的习惯是,编译完先在本地命令行跑一次:
code复制SysMets1.exe
如果能看到窗口正常弹出,再谈分发。如果本地也起不来,多半是链接阶段少了库,或者入口函数写成了 main 而不是 WinMain。入口错了,链接器会报 unresolved external symbol main 一类的错误,根本走不到 PE 生成那一步——这反而是好事,至少你看到了明确提示。
4.3 滚动边框不出现?先检查窗口样式
还有一个实测时经常遇到的视觉问题:程序跑起来之后,窗口里没有滚动条。原因不是 SetScrollRange 没调,而是窗口类注册时少了 WS_HSCROLL 或 WS_VSCROLL 样式。
SysMets1 在 CreateWindow 里创建的是带有这两个样式的普通重叠窗口:
cpp复制CreateWindow(szAppName, TEXT("SysMets1"),
WS_OVERLAPPEDWINDOW | WS_VSCROLL | WS_HSCROLL,
CW_USEDEFAULT, CW_USEDEFAULT,
CW_USEDEFAULT, CW_USEDEFAULT,
NULL, NULL, hInstance, NULL);
如果你只写了 WS_OVERLAPPEDWINDOW,滚动条控件就不会出现,接下来所有 SetScrollInfo 虽然不会报错,但全都白调。这个跟"创建子窗口滚动条"还不一样,子窗口滚动条是独立控件,需要 CreateWindow 建出来;但窗口自带的这个滚动条,只要在样式里给上,系统自动管理。
顺带一提,窗口自带的滚动条区域也参加了 WM_SIZE 的客户区计算。SysMets1 的垂直滚动条宽度是 GetSystemMetrics(SM_CXVSCROLL),水平滚动条高度是 GetSystemMetrics(SM_CYHSCROLL)。窗口被拉伸时,客户区会自动扣掉滚动条占用的空间,所以滚动范围计算里不需要手动减这些值,系统已经处理完了。如果你是自己布局一个子窗口控件当滚动条,那就要手动处理这些边距,复杂度会上升一个级别。
5. 由 SysMets1 延伸出去的滚动交互:键盘、滚轮与子类化
5.1 键盘方向键滚动:SysMets2 的思路
SysMets1 只能靠鼠标点滚动条,很反直觉。所以教材下一版 SysMets2 就是给窗口加键盘响应。核心逻辑是把 WM_KEYDOWN 消息里的方向键映射到滚动请求上:
cpp复制case WM_KEYDOWN:
switch (wParam)
{
case VK_UP: SendMessage(hwnd, WM_VSCROLL, SB_LINEUP, 0); break;
case VK_DOWN: SendMessage(hwnd, WM_VSCROLL, SB_LINEDOWN, 0); break;
case VK_PRIOR: SendMessage(hwnd, WM_VSCROLL, SB_PAGEUP, 0); break;
case VK_NEXT: SendMessage(hwnd, WM_VSCROLL, SB_PAGEDOWN, 0); break;
case VK_HOME: SendMessage(hwnd, WM_VSCROLL, SB_TOP, 0); break;
case VK_END: SendMessage(hwnd, WM_VSCROLL, SB_BOTTOM, 0); break;
}
break;
这里用 SendMessage 把自己窗口的过程又调了一遍,属于很聪明的"复用现有逻辑"做法。你可能会问,为什么不直接写个函数处理滚动,而要用 SendMessage?因为 SendMessage 会触发完整的窗口过程,包括后续可能存在的 WM_NOTIFY 等扩展逻辑,在大型项目里,这种"向滚动条发消息"的方式更容易保持单一入口,不会被拆散。
使用键盘滚动还引出一个容易被忽略的细节:窗口必须有输入焦点。WM_KEYDOWN 只会发给当前有焦点的窗口。SysMets2 里要么把窗口类用 CS_HREDRAW | CS_VREDRAW 之类样式处理,要么在点击窗口时主动 SetFocus(hwnd)。不过窗口类默认是可以接收键盘消息的,前提是它没有创建子控件。一旦窗口里有子窗口按钮,焦点默认落在子控件上,主窗口就收不到键盘消息了。这个坑我调试过很久,最终解决方案是在 WM_SETFOCUS 里强制把焦点设回主窗口,或者干脆用 IsDialogMessage 做消息转译。
5.2 鼠标滚轮:WM_MOUSEWHEEL 的处理粒度
现代用户早就习惯鼠标滚轮上下翻页。Win32 里滚轮消息是 WM_MOUSEWHEEL,它的 wParam 高位带了一个有符号的 delta 值,通常一次滚轮是 120 的倍数,向上滚是正数,向下滚是负数。
SysMets1 如果要支持滚轮,一个务实的写法是:
cpp复制case WM_MOUSEWHEEL:
{
int zDelta = GET_WHEEL_DELTA_WPARAM(wParam);
int iScroll = - (zDelta / WHEEL_DELTA) * 3;
if (iScroll != 0)
SendMessage(hwnd, WM_VSCROLL,
iScroll > 0 ? SB_LINEUP : SB_LINEDOWN, 0);
break;
}
这里乘以 3 是我个人的偏好,滚一格默认滚 3 行,比一行一行滚更快,也比一页一页滚更精细。你也可以做成每次滚 cyClient / cyChar 的一页,但会觉得很"跳"。平滑滚轮(高精度触控板)会把 delta 拆成很小的值,比如 30、60,这时直接按 zDelta / WHEEL_DELTA 计算会得到 0,导致滚轮无反应。更稳妥的做法是累积剩余值,或者直接用 GetScrollInfo 返回的 nPos 去惯性滚动。这个细节在越做越深时会踩到。
还有一点:WM_MOUSEWHEEL 默认发送给鼠标指针下的窗口,而不是有焦点的窗口,除非你在 WM_MOUSEWHEEL 里手动 SendMessage 给目标窗口。SysMets1 的窗口通常独占鼠标,所以不用管;一旦你做成复杂界面,鼠标悬停在子窗口上滚轮,父窗口的滚动条不动,那就要做消息路由了。
5.3 性能优化方向:ScrollWindow 与双缓冲
SysMets1 的绘制非常轻,InvalidateRect 全屏重绘完全没问题。但如果你把系统指标换成几千条日志文本,或者大尺寸位图,整窗重绘的性能就会暴露出来。
这时候有两个经典手段。
第一个是 ScrollWindow / ScrollWindowEx。它能把客户区已有的内容先平移一段距离,只重绘露出来的新区域。你在滚动逻辑里算好滚动增量,调用:
cpp复制ScrollWindow(hwnd, 0, -cyChar * (iVscrollPos - oldPos), NULL, NULL);
窗口内容平移后,Windows 会为露出的区域安排重绘。这种增量绘制的效率远高于全量重绘,缺点是代码里要小心处理滚动区域和无效矩形,容易漏掉边角。
第二个是双缓冲。先在内存 DC 上画完整帧,再一次 BitBlt 到窗口。滚动时内存 DC 里的旧内容可以直接 BitBlt 平移,比 ScrollWindow 的窗口平移更可控,也不会闪烁。到这一步,你就从"跟着教材写窗口"进化到"自己设计渲染管线"了,SysMets1 的意义也就完成了。
写在最后:我重新跑 SysMets1 时的一点体会
距离第一次照着书敲 SysMets1 已经过去很久,最近为了写这篇文章又把它翻出来编译了一遍。让我意外的是,当年以为已经吃透的滚动逻辑,再看仍有新收获:SetScrollInfo 的 SIF_PAGE 到底怎么影响滚动框尺寸,WM_MOUSEWHEEL 的 delta 累积问题怎么处理,DPI 缩放对字体度量的干扰有多大——这些问题当年根本没概念,是在后来做实际项目时才一个个撞上来的。
SysMets1 表面上是"滚动条入门",实际上是一面照妖镜。它把我对"窗口、消息、绘制、状态"四个概念的掌握程度照得清清楚楚。如果你也在学 Win32,别只满足于让这个例子跑起来,试着改改滚动范围、加个键盘响应、换一种字体、做成双缓冲,每改一处,你对这套机制的理解都会更扎实一层。
