基于父窗口控制子窗口大小位置及Z序异常问题排查

问题背景 #

我正在开发一款类似拆分栏的高级窗格管理器控件。父窗口（可能是主窗口）负责创建该控件实例，再创建若干子窗口并注册到控件中。

注册子窗口时，会调用子窗口的SetWindowPos()，设置HWND_TOP层级及SWP_NOMOVE | SWP_NOSIZE | SWP_NOOWNERZORDER样式，此时子窗口显示正常。

异常现象：主窗口调整大小时，控件判定部分子窗口只需移动而非调整大小，这些被移动的子窗口Z序会交替出现被控件遮挡、恢复上层的情况。怀疑主窗口调整大小时，子窗口的父窗口调用DefWindowProc()，在我发送的移动/调整命令之外额外触发了相关操作？在无法控制父窗口的情况下该如何解决？

相关代码 #

LRESULT PaneMgrWinProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch(uMsg)
    {
        case CPMM_REGISTERPANE:
        {
            LPPANESTRUCT pane = (LPPANESTRUCT)lParam;
            g_hWndZone1Pane = pane->hWnd;
            SetWindowPos(m_hWndZone1Pane , HWND_TOP, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOOWNERZORDER);
        return 0L;
        }

        case WM_MOVE:
        {
            RECT rc = {0};
            GetPaneRect(ZONE1, &rc);
            MapWindowPoints(hWnd, GetParent(g_hWndZone1Pane), &rc, 2);
            SetWindowPos(g_hWndZone1Pane, 0, rc.left, rc.top, 0, 0, (SWP_NOZORDER | SWP_NOSIZE));
            return 0L;
        }

        case WM_SIZE:
        {
            RECT rc = {0};
            GetPaneRect(ZONE1, &rc);
            MapWindowPoints(hWnd, GetParent(g_hWndZone1Pane), &rc, 2);
            SetWindowPos(g_hWndZone1Pane, 0, rc.left, rc.top, (rc.right - rc.left), (rc.bottom - rc.top), SWP_NOZORDER);
            return 0L;
        }
    }
    return DefWindowProc(hWnd, uMsg, wParam, lParam);
}

核心原因 #

Windows窗口的Z序管理逻辑中，当父窗口收到WM_SIZE/WM_MOVE消息时，DefWindowProc()可能会根据窗口类的默认行为自动调整子窗口的布局或Z序，这会覆盖你手动设置的Z序参数。另外，当前代码中移动子窗口时使用SWP_NOZORDER，仅保留当前Z序，一旦父窗口触发额外的Z序调整，就会出现子窗口被控件遮挡的情况。

解决方法 #

1. 强制子窗口始终处于控件上层 #

在移动或调整子窗口时，不要使用SWP_NOZORDER，而是显式指定HWND_TOP（或HWND_TOPMOST，根据需求选择），同时保留SWP_NOOWNERZORDER避免干扰父窗口的Z序链：

// WM_MOVE中修改后的调用
SetWindowPos(g_hWndZone1Pane, HWND_TOP, rc.left, rc.top, 0, 0, SWP_NOSIZE | SWP_NOOWNERZORDER);

// WM_SIZE中修改后的调用
SetWindowPos(g_hWndZone1Pane, HWND_TOP, rc.left, rc.top, (rc.right - rc.left), (rc.bottom - rc.top), SWP_NOOWNERZORDER);

如果担心单次调用被覆盖，也可以在移动/调整后额外调用一次SetWindowPos加固Z序：

SetWindowPos(g_hWndZone1Pane, HWND_TOP, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOOWNERZORDER);

2. 拦截子窗口的Z序修改消息 #

如果子窗口是你可控的，可以在子窗口的窗口过程中拦截WM_WINDOWPOSCHANGING消息，强制将Z序恢复到顶层：

LRESULT ChildWinProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch(uMsg)
    {
        case WM_WINDOWPOSCHANGING:
        {
            WINDOWPOS* wp = reinterpret_cast<WINDOWPOS*>(lParam);
            // 检测到Z序被修改为非顶层时，强制恢复
            if (wp->hwndInsertAfter != HWND_TOP && wp->hwndInsertAfter != HWND_TOPMOST)
            {
                wp->hwndInsertAfter = HWND_TOP;
                wp->flags &= ~SWP_NOZORDER; // 确保Z序修改生效
            }
            break;
        }
    }
    return DefWindowProc(hWnd, uMsg, wParam, lParam);
}

3. 固定控件的底层Z序 #

确保窗格管理器控件始终处于所有子窗口的下方。可以在控件创建完成后调用：

SetWindowPos(hWnd, HWND_BOTTOM, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);

这样所有注册的子窗口默认都会显示在控件上层，从根源避免遮挡问题。

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