Win32 ListView自绘时如何调整WM_NCCALCSIZE三矩形覆盖内置滚动条区域

核心概念：LPNCCALCSIZE_PARAMS中rgrc数组的语义约定 #

当WM_NCCALCSIZE的wParam参数为TRUE时，系统和窗口过程对rgrc数组的读写规则是固定的：

• 系统传入阶段的初始值：
  • rgrc[0]：计算尺寸调整后的完整窗口外边界矩形，还未扣除任何非客户区元素
  • rgrc[1]：上一次窗口的完整外边界矩形
  • rgrc[2]：上一次窗口的客户区边界矩形
• 窗口过程输出阶段的调整值：
  • rgrc[0]：自定义的新客户区边界矩形，该矩形范围外的所有区域会被系统划定为非客户区，不会触发客户区绘制流程
  • 若返回值包含WVR_VALIDRECTS，则rgrc[1]和rgrc[2]需要被设置为有效的重绘区域上下界，用于减少窗口重绘时的无效绘制开销

现有代码的逻辑偏差 #

你当前实现的方向完全颠倒了矩形调整逻辑：

• ListView的内置水平、垂直滚动条，本身属于非客户区元素：当内容超出客户区时，系统会自动在窗口右侧、底部划出对应尺寸的非客户区区域放置滚动条，这个阶段初始传入的rgrc[0]已经把滚动条区域从客户区中扣除了
• 你现在把rgrc[0]的右、下边界向外扩展滚动条尺寸，相当于把客户区画到了窗口边界外面，既无法覆盖原本的滚动条区域，还会导致客户区溢出、内容绘制错位
• 返回WVR_VALIDRECTS时的矩形赋值顺序错误：你将原本的新窗口矩形、旧窗口矩形的位置放反了，无法触发系统的重绘优化逻辑，还会引发绘制异常

正确的调整实现 #

要让客户区完全覆盖ListView的内置滚动条区域，需要把原本被系统扣除的滚动条区域，重新纳入rgrc[0]的客户区范围：

1. 先缓存系统初始传入的三个原始矩形，避免提前覆盖丢失原始参数
2. 新的客户区直接取完整的新窗口外边界，相当于把所有原本分给滚动条的非客户区，全部划回客户区范围
3. 按照WVR_VALIDRECTS的要求正确配对两个边界矩形

case WM_NCCALCSIZE:
{
    if (wParam == TRUE)
    {
        LPNCCALCSIZE_PARAMS calcParam = (LPNCCALCSIZE_PARAMS)lParam;
        // 缓存系统传入的原始参数
        RECT rcNewWindowFull = calcParam->rgrc[0];
        RECT rcOldWindowFull = calcParam->rgrc[1];
        RECT rcOldClient = calcParam->rgrc[2];

        // 将客户区扩展到覆盖整个窗口边界（即把所有滚动条区域纳入客户区）
        RECT rcNewClient = rcNewWindowFull;

        // 写入调整后的客户区矩形
        calcParam->rgrc[0] = rcNewClient;
        // 按WVR_VALIDRECTS要求设置有效重绘边界
        calcParam->rgrc[1] = rcOldWindowFull;
        calcParam->rgrc[2] = rcOldClient;

        return WVR_VALIDRECTS;
    }
    return DefWindowProc(hWnd, message, wParam, lParam);
}

关键注意事项 #

• 客户区覆盖滚动条区域后，ListView内置的系统滚动条会因为没有专属的非客户区空间而完全隐藏，如果需要保留滚动交互，需要自行实现滚动条绘制、滚动消息响应逻辑
• 不要在计算中硬编码固定的滚动条尺寸增量：高DPI场景下滚动条实际尺寸会随系统配置动态变化，上述实现是基于系统初始传入的完整窗口边界做覆盖，不需要额外查询滚动条尺寸
• 垂直、水平滚动条交汇的角落空白区域，也会被自动纳入客户区，不会出现原生ListView的滚动条留白
• 如果只需要覆盖某一个方向的滚动条，只需要对应保留客户区在另一方向的边界扣除逻辑即可

内容的提问来源于stack exchange，提问作者Younth