为何自定义类实现的Windows托盘程序无需调用DispatchMessage仍可运行？

这是我第一次在此发帖，若问题表述不清或结构不佳，敬请谅解。我会尽力清晰说明问题。

目前我正在学习C++ Windows应用编程，尝试创建一个系统托盘（systray）程序。我已成功实现右键点击托盘图标时弹出消息框并退出程序的功能。

但在将托盘功能封装到自定义类后，我遇到了一个无法完全理解的特殊现象。

我的代码分为三个文件：

main.cpp #

int APIENTRY wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nCmdShow)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);  

    std::unique_ptr<windowsSystray> driver = std::make_unique<windowsSystray>(hInstance, nullptr, L"Tree App");

    MSG msg;
    while (GetMessage(&msg, nullptr, 0, 0))
    {
        // Normally, we'd call DispatchMessage here, but this works without it.       
    }

    if (hAppMutex) CloseHandle(hAppMutex);
    return static_cast<int>(msg.wParam);
}

windowsSystray.h #

class windowsSystray :
    public SystrayDriver
{
public:
    windowsSystray(HINSTANCE hInstance, HWND hWnd, const std::wstring& tooltipText);
    ~windowsSystray();

private:  
    void registerWindowClass();
    void createSystrayWindow();
    void unregisterWindowClass();
    
    void addIcon() override;
    void removeIcon() override;
    
    static LRESULT CALLBACK HandleMessage(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);

    static NOTIFYICONDATA nidApp;
    static HMENU hPopMenu;    
    
    HINSTANCE hInst;
    HWND hWnd;
    std::wstring tooltipText;
};

windowsSystray.cpp #

#include "windowsSystray.h"

NOTIFYICONDATA windowsSystray::nidApp = { 0 };

windowsSystray::windowsSystray(HINSTANCE hInstance, HWND hWnd, const std::wstring& tooltipText)
    : hInst(hInstance), hWnd(hWnd), tooltipText(tooltipText) {

    registerWindowClass();  
    createSystrayWindow();   
    addIcon();
}

windowsSystray::~windowsSystray() { 
    removeIcon();
    unregisterWindowClass();
}

void windowsSystray::registerWindowClass() {
    WNDCLASSEX wc;
    wc.cbSize = sizeof(WNDCLASSEX);
    wc.style = CS_HREDRAW | CS_VREDRAW;
    wc.lpfnWndProc = HandleMessage;
    wc.cbClsExtra = 0;
    wc.cbWndExtra = 0;
    wc.hInstance = hInst;
    wc.hIcon = LoadIcon(hInst, MAKEINTRESOURCE(IDI_SYSTRAY_ICON));
    wc.hCursor = LoadCursor(NULL, IDC_ARROW);
    wc.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
    wc.lpszMenuName = MAKEINTRESOURCE(IDM_SYSTRAY);
    wc.lpszClassName = L"TreeSystrayClass";
    wc.hIconSm = LoadIcon(hInst, MAKEINTRESOURCE(IDI_SYSTRAY_ICON));
    RegisterClassEx(&wc);
}


void windowsSystray::createSystrayWindow() {    
    HICON hMainIcon = LoadIcon(hInst, (LPCTSTR)MAKEINTRESOURCE(IDI_SYSTRAY_ICON));
    hWnd = hWnd;
    hWnd = CreateWindow(L"TreeSystrayClass", L"treeCollector", WS_OVERLAPPEDWINDOW,
        CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInst, NULL);

    if (!hWnd) return;

    nidApp.cbSize = sizeof(NOTIFYICONDATA);                         // sizeof the struct in bytes 
    nidApp.hWnd = (HWND)hWnd;                                       //handle of the window which will process this app. messages 
    nidApp.uID = IDI_SYSTRAY_ICON;                                  //ID of the icon that willl appear in the system tray 
    nidApp.uFlags = NIF_ICON | NIF_MESSAGE | NIF_TIP;               //ORing of all the flags 
    nidApp.hIcon = hMainIcon;                                       // handle of the Icon to be displayed, obtained from LoadIcon 
    nidApp.uCallbackMessage = WM_SYSTRAY;
}

void windowsSystray::unregisterWindowClass() {
    UnregisterClass(L"TreeSystrayClass", hInst);
}

void windowsSystray::addIcon() {
    Shell_NotifyIcon(NIM_ADD, &nidApp);
}

void windowsSystray::removeIcon() {
    Shell_NotifyIcon(NIM_DELETE, &nidApp);
}

LRESULT CALLBACK windowsSystray::HandleMessage(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) {

    int wmId, wmEvent;
    //POINT lpClickPoint;

    switch (message)
    {

    case WM_SYSTRAY:
        switch (LOWORD(lParam))
        {
        case WM_RBUTTONDOWN:
            MessageBox(hwnd, TEXT("HERE1"), TEXT("Tree"), MB_OK);
            Shell_NotifyIcon(NIM_DELETE, &nidApp);
            DestroyWindow(hwnd);
        }
        break;
    case WM_COMMAND:
        wmId = LOWORD(wParam);
        wmEvent = HIWORD(wParam);
        // Parse the menu selections:
        switch (wmId)
        {
        /*case IDC_MENU_ABOUT:
            MessageBox(hwnd, TEXT("HERE2"), TEXT("Tree"), MB_OK);
            break;*/
        default:
            return DefWindowProc(hwnd, message, wParam, lParam);
        }
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hwnd, message, wParam, lParam);
    }
    return 0;
}

问题描述 #

将托盘功能封装到windowsSystray类中运行程序时，程序会创建图标并停留在GetMessage()循环中，即便主循环内从未调用DispatchMessage()，程序仍能正常工作。

疑问 #

1. 为何未调用DispatchMessage()的GetMessage()循环仍能正常运行？Windows是否会在我未显式调用DispatchMessage()时自动调用消息处理函数？
2. 使用自定义类管理托盘时，这种行为是否符合预期？还是我遗漏了某些基础知识？

解答 #

问题1：未调用DispatchMessage仍能运行的原因

Windows不会自动替你调用窗口过程函数，你的场景能运行是因为特殊的消息传递机制：

• 托盘图标由系统Shell（explorer.exe）管理，当用户和托盘图标交互时，Shell会直接向你指定的窗口（nidApp.hWnd）发送WM_SYSTRAY消息，这个过程绕过了你的主消息循环，不需要DispatchMessage分发。
• 你调用DestroyWindow(hwnd)后，系统会直接给窗口发送WM_DESTROY消息，同样不需要经过主消息循环，所以PostQuitMessage(0)能被执行，让GetMessage返回0退出循环。
• 这种“正常工作”是非常局限的——如果你的窗口需要处理常规消息（比如WM_PAINT、菜单WM_COMMAND），这些消息会堆积在消息队列里无法被处理，程序会出现假死或功能失效。

问题2：自定义类管理托盘的行为是否符合预期

这种行为不符合Windows消息循环的规范，只是你的特定场景刚好跑通了。不管是否用类封装，正确的消息循环必须包含DispatchMessage：

while (GetMessage(&msg, nullptr, 0, 0))
{
    DispatchMessage(&msg);
}

省略DispatchMessage会导致大量窗口消息无法被处理，比如后续给托盘添加右键菜单时，菜单的WM_COMMAND消息就需要通过DispatchMessage分发到窗口过程才能响应；如果你的主窗口被显示出来，它的绘制、输入等消息都会堆积，导致窗口无法正常工作。

用类封装WinAPI窗口是完全可行的，但必须遵循Windows的消息处理机制，不能省略DispatchMessage。你的第一个未用类的版本出现同样现象，本质是一样的——都是依赖系统直接发送的消息完成了有限逻辑，不是正确的实现方式。

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