Win32 API Rust停靠窗口导致任务栏无法自动隐藏的问题排查

我用Rust结合Win32 API创建了一个停靠在屏幕顶部的简单窗口，但运行代码后任务栏会立即重新显示，无法设置为自动隐藏；即便在系统设置里切换“自动隐藏任务栏”选项，任务栏还是会重新出现。相关代码如下：

use std::{ffi::OsStr, os::windows::ffi::OsStrExt, ptr::null_mut};
use windows_sys::Win32::System::LibraryLoader::GetModuleHandleW;
use windows_sys::Win32::UI::{Shell::*, WindowsAndMessaging::*};
use windows_sys::Win32::Graphics::Gdi::UpdateWindow;
use windows_sys::Win32::Foundation::*;
use std::mem::zeroed;

const WM_APPBAR: u32 = WM_USER + 1;

pub fn to_wstring(str: &str) -> Vec<u16> { OsStr::new(str)
    .encode_wide().chain(Some(0).into_iter()).collect() }

unsafe extern "system" fn wnd_proc(hwnd: HWND, msg: u32, wp: WPARAM, lp: LPARAM) -> LRESULT {
    match msg {
        WM_APPBAR => {
            if lp == ABN_POSCHANGED as isize ||
               lp == ABN_STATECHANGE as isize
            { update_appbar(hwnd); } 0
        },
        WM_DESTROY => {
            let mut abd: APPBARDATA = std::mem::zeroed();
            abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
            abd.hWnd = hwnd; abd.uEdge = ABE_TOP;
            abd.rc = RECT { left: 0, top: 0, right: GetSystemMetrics(SM_CXSCREEN), bottom: 30 };
            abd.lParam = ABS_ALWAYSONTOP as isize;
            abd.uCallbackMessage = WM_APPBAR;
            SHAppBarMessage(ABM_REMOVE, &mut abd);
            PostQuitMessage(0);
            0
        },
        _ => DefWindowProcW(hwnd, msg, wp, lp)
    }
}

fn main() {
    unsafe {
        RegisterClassW(&WNDCLASSW {
            lpszClassName: to_wstring("utilbar_main_toolbar").as_ptr(),
            hCursor: LoadCursorW(null_mut(), IDC_ARROW),
            hInstance: GetModuleHandleW(null_mut()),
            cbClsExtra: 0, cbWndExtra: 0,
            lpfnWndProc: Some(wnd_proc),
            hbrBackground: null_mut(),
            lpszMenuName: null_mut(),
            hIcon: null_mut(),
            style: 0,
        });
        let hwnd = CreateWindowExW(
            WS_EX_TOOLWINDOW | WS_EX_NOACTIVATE,
            to_wstring("utilbar_main_toolbar").as_ptr(),
            to_wstring("").as_ptr(),
            WS_POPUP,
            0,
            0,
            GetSystemMetrics(SM_CXSCREEN),
            30,
            null_mut(),
            null_mut(),
            GetModuleHandleW(null_mut()),
            null_mut()
        );
        ShowWindow(hwnd, SW_SHOW); UpdateWindow(hwnd); update_appbar(hwnd);

        let taskbar_hwnd = FindWindowW(to_wstring("Shell_TrayWnd").as_ptr(), null_mut());
        let mut abd: APPBARDATA = std::mem::zeroed(); abd.lParam = ABS_AUTOHIDE as isize;
        abd.cbSize = size_of::<APPBARDATA>() as u32; abd.hWnd = taskbar_hwnd;
        SHAppBarMessage(ABM_SETSTATE, &mut abd);

        let mut msg: MSG = zeroed();
        while GetMessageW(&mut msg, hwnd, 0, 0) > 0
        { TranslateMessage(&msg); DispatchMessageW(&msg); }
    }
}

unsafe fn update_appbar(hwnd: HWND) {
    let mut abd: APPBARDATA = std::mem::zeroed();
    abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
    abd.hWnd = hwnd; abd.uEdge = ABE_TOP;
    abd.rc = RECT { left: 0, top: 0, right: GetSystemMetrics(SM_CXSCREEN), bottom: 30 };
    abd.lParam = ABS_ALWAYSONTOP as isize;
    abd.uCallbackMessage = WM_APPBAR;
    SHAppBarMessage(ABM_NEW, &mut abd);
    SHAppBarMessage(ABM_SETPOS, &mut abd);
    SHAppBarMessage(ABM_SETSTATE, &mut abd);
    SetWindowPos(hwnd, null_mut(), 0, 0, 0, 0, SWP_NOSIZE | SWP_NOZORDER);
}

• 重复注册AppBar触发布局重算：update_appbar函数在每次收到WM_APPBAR消息（包括任务栏状态变化的ABN_STATECHANGE）时，都会调用ABM_NEW重新注册AppBar，这会强制Shell重新计算桌面布局，直接覆盖你设置的任务栏自动隐藏状态。
• 任务栏状态设置时机错误：在main中设置任务栏自动隐藏后，后续执行的update_appbar操作会干扰Shell的状态管理，导致任务栏被强制重新显示。
• AppBar状态设置逻辑冲突：给自定义窗口调用ABM_SETSTATE设置ABS_ALWAYSONTOP时，没有正确处理与系统任务栏的状态交互，Shell会优先保证AppBar的可见性，进而强制任务栏保持显示。

1. 移除重复的AppBar注册逻辑 #

只在窗口创建时执行一次ABM_NEW注册，删除update_appbar中的SHAppBarMessage(ABM_NEW, &mut abd);调用，将注册逻辑移到main中窗口创建完成后。

2. 优化WM_APPBAR消息处理 #

仅在收到ABN_POSCHANGED（位置变化）时更新AppBar位置，避免在ABN_STATECHANGE（状态变化）时触发操作，防止干扰任务栏状态：

unsafe extern "system" fn wnd_proc(hwnd: HWND, msg: u32, wp: WPARAM, lp: LPARAM) -> LRESULT {
    match msg {
        WM_APPBAR => {
            if lp == ABN_POSCHANGED as isize {
                update_appbar(hwnd);
            }
            0
        },
        WM_DESTROY => {
            let mut abd: APPBARDATA = std::mem::zeroed();
            abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
            abd.hWnd = hwnd;
            SHAppBarMessage(ABM_REMOVE, &mut abd);
            PostQuitMessage(0);
            0
        },
        _ => DefWindowProcW(hwnd, msg, wp, lp)
    }
}

3. 简化update_appbar函数 #

只保留位置更新逻辑，移除不必要的状态设置和重复注册：

unsafe fn update_appbar(hwnd: HWND) {
    let mut abd: APPBARDATA = std::mem::zeroed();
    abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
    abd.hWnd = hwnd;
    abd.uEdge = ABE_TOP;
    abd.rc = RECT { left: 0, top: 0, right: GetSystemMetrics(SM_CXSCREEN), bottom: 30 };
    SHAppBarMessage(ABM_SETPOS, &mut abd);
    SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOZORDER);
}

4. 调整main函数执行流程 #

先完成AppBar的注册和位置设置，再设置任务栏自动隐藏，避免操作顺序导致的状态覆盖：

fn main() {
    unsafe {
        // 注册窗口类
        RegisterClassW(&WNDCLASSW {
            lpszClassName: to_wstring("utilbar_main_toolbar").as_ptr(),
            hCursor: LoadCursorW(null_mut(), IDC_ARROW),
            hInstance: GetModuleHandleW(null_mut()),
            cbClsExtra: 0, cbWndExtra: 0,
            lpfnWndProc: Some(wnd_proc),
            hbrBackground: null_mut(),
            lpszMenuName: null_mut(),
            hIcon: null_mut(),
            style: 0,
        });

        // 创建窗口
        let hwnd = CreateWindowExW(
            WS_EX_TOOLWINDOW | WS_EX_NOACTIVATE,
            to_wstring("utilbar_main_toolbar").as_ptr(),
            to_wstring("").as_ptr(),
            WS_POPUP,
            0,
            0,
            GetSystemMetrics(SM_CXSCREEN),
            30,
            null_mut(),
            null_mut(),
            GetModuleHandleW(null_mut()),
            null_mut()
        );

        ShowWindow(hwnd, SW_SHOW);
        UpdateWindow(hwnd);

        // 首次注册AppBar
        let mut abd: APPBARDATA = std::mem::zeroed();
        abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
        abd.hWnd = hwnd;
        abd.uCallbackMessage = WM_APPBAR;
        SHAppBarMessage(ABM_NEW, &mut abd);

        // 设置AppBar位置
        update_appbar(hwnd);

        // 设置任务栏自动隐藏
        let taskbar_hwnd = FindWindowW(to_wstring("Shell_TrayWnd").as_ptr(), null_mut());
        let mut taskbar_abd: APPBARDATA = std::mem::zeroed();
        taskbar_abd.cbSize = std::mem::size_of::<APPBARDATA>() as u32;
        taskbar_abd.hWnd = taskbar_hwnd;
        taskbar_abd.lParam = ABS_AUTOHIDE as isize;
        SHAppBarMessage(ABM_SETSTATE, &mut taskbar_abd);

        // 消息循环
        let mut msg: MSG = zeroed();
        while GetMessageW(&mut msg, hwnd, 0, 0) > 0 {
            TranslateMessage(&msg);
            DispatchMessageW(&msg);
        }
    }
}

内容的提问来源于stack exchange，提问作者Barnabás