SetWindowPos无法正确设置窗口Z序问题排查求助

我正在开发一款窗口管理器，实现了窗口斜向堆叠的功能，但遇到Z序随机混乱的问题——窗口坐标显示正确，但堆叠顺序经常出错，即使将所有窗口设为HWND_TOP也无法解决。当前仅用于管理文件资源管理器窗口。

问题代码 #

void stack_windows_diagonal(HWND* windows, int width, int height){
    if(windows == NULL) return;

    int size = 0;
    for(;windows[size]; size++);

    RECT scr_dim;
    scr_dim.left   = GetSystemMetrics(SM_XVIRTUALSCREEN);
    scr_dim.top    = GetSystemMetrics(SM_YVIRTUALSCREEN);
    scr_dim.right  = GetSystemMetrics(SM_CXVIRTUALSCREEN);
    scr_dim.bottom = GetSystemMetrics(SM_CYVIRTUALSCREEN);

    int xoffset = 40;
    int yoffset = 40;

    int startx = (scr_dim.right - width) / 2 - (((size - 1) * xoffset) / 2);
    int starty = (scr_dim.bottom - height) / 2 - (((size - 1) * yoffset) / 2);

    for(int i = size - 1; i >= 0; i--){
        bool success = SetWindowPos(windows[i], i == size - 1? HWND_TOP : windows[i - 1], startx + xoffset * i, starty + yoffset * i, width, height, 0);
        if(!success) {
            DWORD error = GetLastError();
            fprintf(stderr, "Failed to reposition window. Error code: %lu\n", error);
            continue;
        }

        if(i < size - 1)
            continue;

        success = SetForegroundWindow(windows[i]);
        if(!success){
            DWORD error = GetLastError();
            if(GetLastError())
                fprintf(stderr, "Failed to bring window to top. Error code: %lu\n", error);
        }

    }

    free(windows);

}

（windows数组以NULL结尾）

问题截图 #

问题根源 #

1. Z序插入逻辑完全颠倒：循环从最后一个窗口倒序处理到第一个，但SetWindowPos的hWndInsertAfter参数使用windows[i-1]（非最后一个窗口时）。此时windows[i-1]还未被处理，且它在数组中是本应处于更底层的窗口，导致当前窗口被插入到错误层级，直接打乱堆叠顺序。
2. 激活窗口干扰Z序：调用SetForegroundWindow会强制激活目标窗口，Windows窗口管理器可能会为响应激活操作调整其他窗口的Z序，破坏预期的堆叠结构。
3. 缺少关键标志位：SetWindowPos未传入SWP_NOACTIVATE | SWP_NOOWNERZORDER，可能触发窗口自动激活或父窗口的Z序规则，干扰手动设置的堆叠顺序。

修复后的代码 #

void stack_windows_diagonal(HWND* windows, int width, int height){
    if(windows == NULL) return;

    int size = 0;
    for(;windows[size]; size++);

    RECT scr_dim;
    scr_dim.left   = GetSystemMetrics(SM_XVIRTUALSCREEN);
    scr_dim.top    = GetSystemMetrics(SM_YVIRTUALSCREEN);
    scr_dim.right  = GetSystemMetrics(SM_CXVIRTUALSCREEN);
    scr_dim.bottom = GetSystemMetrics(SM_CYVIRTUALSCREEN);

    int xoffset = 40;
    int yoffset = 40;

    int startx = (scr_dim.right - width) / 2 - (((size - 1) * xoffset) / 2);
    int starty = (scr_dim.bottom - height) / 2 - (((size - 1) * yoffset) / 2);

    // 从底层到顶层依次处理，保证Z序正确
    for(int i = 0; i < size; i++){
        // 第一个窗口放在最底层，后续每个窗口放在前一个窗口的上方
        HWND insert_after = (i == 0) ? HWND_BOTTOM : windows[i-1];
        // 使用SWP_NOACTIVATE避免激活窗口，SWP_NOOWNERZORDER防止父窗口干扰
        bool success = SetWindowPos(windows[i], insert_after, 
                                   startx + xoffset * i, starty + yoffset * i, 
                                   width, height, SWP_NOACTIVATE | SWP_NOOWNERZORDER);
        if(!success) {
            DWORD error = GetLastError();
            fprintf(stderr, "Failed to reposition window. Error code: %lu\n", error);
            continue;
        }
    }

    // 若需要将最后一个窗口设为顶层且激活，单独处理（可选）
    if(size > 0){
        bool success = SetWindowPos(windows[size-1], HWND_TOP, 0, 0, 0, 0, 
                                   SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
        if(success){
            SetForegroundWindow(windows[size-1]);
        } else {
            DWORD error = GetLastError();
            fprintf(stderr, "Failed to bring top window to front. Error code: %lu\n", error);
        }
    }

    free(windows);
}

修复说明 #

• 调整循环顺序：从第一个窗口到最后一个窗口依次处理，每个窗口放在前一个窗口的上方，保证Z序从底到顶依次堆叠。
• 添加关键标志位：SWP_NOACTIVATE避免窗口自动激活，SWP_NOOWNERZORDER防止父窗口的Z序规则干扰当前设置。
• 分离顶层设置逻辑：将顶层窗口的激活操作单独处理，避免干扰整个堆叠过程的Z序。

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