一、引言：为什么需要系统托盘 + 协程调度？

在许多常驻程序（例如杀毒软件、VPN 客户端、同步工具）中，我们会看到程序最小化至系统托盘（任务栏通知区域），具备如下特性：

后台运行
可被右键菜单/左键双击唤醒
状态显示（图标变化）
弹出消息通知
托盘控制行为触发实际逻辑

若将这些行为与 C++20 协程结合，我们可轻松实现“非阻塞、响应式、状态化”的常驻任务调度系统。

二、目标与功能清单

功能模块	描述
托盘图标注册	在系统托盘区域注册图标，提供可视状态
协程事件响应	响应托盘图标的点击、右键菜单、状态变化，采用协程非阻塞实现
消息通知	从后台异步弹出系统提示通知
后台任务调度	协程支持定时刷新状态、监测变化
跨平台建议支持	优先支持 Windows，后续可拓展 Linux（通过 libappindicator）

三、基础托盘实现（以 Windows 为例）

cpp复制编辑// tray.hpp#include <windows.h>#include <shellapi.h>#define WM_TRAYICON (WM_USER + 1)
NOTIFYICONDATA nid;
HINSTANCE hInstance;
HWND hwnd;void register_tray_icon() {
    hwnd = CreateWindow("STATIC", "CoroTray", WS_OVERLAPPEDWINDOW, 0, 0, 0, 0, nullptr, nullptr, hInstance, nullptr);
    nid.cbSize = sizeof(NOTIFYICONDATA);
    nid.hWnd = hwnd;
    nid.uID = 1;
    nid.uFlags = NIF_MESSAGE | NIF_ICON | NIF_TIP;
    nid.uCallbackMessage = WM_TRAYICON;
    nid.hIcon = LoadIcon(nullptr, IDI_INFORMATION);    strcpy_s(nid.szTip, "协程托盘程序");    Shell_NotifyIcon(NIM_ADD, &nid);
}

四、窗口消息处理与事件绑定

cpp复制编辑LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {    if (uMsg == WM_TRAYICON) {        if (lParam == WM_LBUTTONDBLCLK) {            MessageBox(nullptr, "双击托盘图标", "提示", MB_OK);
        } else if (lParam == WM_RBUTTONUP) {
            HMENU hMenu = CreatePopupMenu();            AppendMenu(hMenu, MF_STRING, 1001, "打开面板");            AppendMenu(hMenu, MF_STRING, 1002, "退出");
            POINT pt;            GetCursorPos(&pt);            SetForegroundWindow(hwnd);            TrackPopupMenu(hMenu, TPM_RIGHTALIGN, pt.x, pt.y, 0, hwnd, nullptr);
        }
    } else if (uMsg == WM_COMMAND) {        switch (LOWORD(wParam)) {        case 1001:            MessageBox(nullptr, "打开面板...", "通知", MB_OK);            break;        case 1002:            PostQuitMessage(0);            break;
        }
    }    return DefWindowProc(hwnd, uMsg, wParam, lParam);
}

五、托盘主程序初始化

cpp复制编辑void init_window_class() {
    WNDCLASS wc = {};
    wc.lpfnWndProc = WindowProc;
    wc.hInstance = hInstance;
    wc.lpszClassName = "CoroTray";    RegisterClass(&wc);
}

六、协程任务封装：任务定时刷状态

cpp复制编辑// coroutine_task.hpptemplate<typename T = void>struct Task {    struct promise_type {
        std::optional<T> value;        Task get_return_object() {            return Task{std::coroutine_handle<promise_type>::from_promise(*this)};
        }        std::suspend_always initial_suspend() noexcept { return {}; }        std::suspend_always final_suspend() noexcept { return {}; }        void return_value(T v) { value = v; }        void unhandled_exception() { std::exit(1); }
    };
    std::coroutine_handle<promise_type> handle;    Task(std::coroutine_handle<promise_type> h) : handle(h) {}
    ~Task() { if (handle) handle.destroy(); }    void start() { handle.resume(); }
};

七、定时器 Awaiter 实现

cpp复制编辑// sleep_awaiter.hpp#include <chrono>#include <thread>struct SleepAwaiter {
    std::chrono::milliseconds duration;    SleepAwaiter(int ms) : duration(ms) {}    bool await_ready() const noexcept { return false; }    void await_suspend(std::coroutine_handle<> h) {
        std::thread([h, d = duration]() {
            std::this_thread::sleep_for(d);
            h.resume();
        }).detach();
    }    void await_resume() const noexcept {}
};

八、协程任务：周期性弹窗与状态变化

cpp复制编辑Task<> background_status_updater() {    while (true) {        // 模拟状态变化
        nid.hIcon = LoadIcon(nullptr, IDI_WARNING);        strcpy_s(nid.szTip, "状态：警告");        Shell_NotifyIcon(NIM_MODIFY, &nid);        co_await SleepAwaiter(5000);
        nid.hIcon = LoadIcon(nullptr, IDI_INFORMATION);        strcpy_s(nid.szTip, "状态：正常");        Shell_NotifyIcon(NIM_MODIFY, &nid);        co_await SleepAwaiter(5000);
    }
}

九、托盘通知弹窗（Balloon）

cpp复制编辑void show_balloon(const std::string& msg) {
    nid.uFlags |= NIF_INFO;    strcpy_s(nid.szInfo, msg.c_str());    strcpy_s(nid.szInfoTitle, "系统通知");
    nid.dwInfoFlags = NIIF_INFO;    Shell_NotifyIcon(NIM_MODIFY, &nid);
}

可在协程中调用：

cpp复制编辑Task<> notify_task() {    co_await SleepAwaiter(3000);    show_balloon("程序已在后台运行");    co_return;
}

十、主程序入口

cpp复制编辑int WINAPI WinMain(HINSTANCE hInst, HINSTANCE, LPSTR, int) {
    hInstance = hInst;    init_window_class();    register_tray_icon();    background_status_updater().start();    notify_task().start();
    MSG msg;    while (GetMessage(&msg, nullptr, 0, 0)) {        TranslateMessage(&msg);        DispatchMessage(&msg);
    }    Shell_NotifyIcon(NIM_DELETE, &nid);    return 0;
}

十一、运行效果演示

托盘区域出现图标
每隔 5 秒状态图标切换（警告 ↔ 正常）
程序启动后 3 秒显示提示消息
用户右键可弹出菜单，点击“退出”关闭程序

十二、可扩展功能建议

扩展项	描述
多状态托盘图标	根据状态切换不同图标、不同提示文字
快捷菜单绑定协程	菜单项可绑定异步协程，如“清理缓存”、“同步数据”等
自动隐藏托盘项	执行完特定任务后自动取消托盘显示
与插件系统结合	托盘点击可调起某插件功能，弹窗响应来自动态模块
Linux 支持	结合 GTK + libappindicator 实现 Linux 托盘（需独立适配）

十三、适用场景示例

后台监控程序（温度/内存状态）
云同步软件状态提醒
日志监控告警工具
VPN/加密代理后台管理器
游戏小工具、拍照助手驻留程序

十四、总结

Windows 系统托盘图标与协程驱动的事件处理器
利用 C++20 协程构建非阻塞任务轮询与弹窗提示
快速响应点击事件、菜单交互、图标切换

协程使得我们无需维护复杂的状态机，也无需多线程，逻辑简单清晰。

ITPub博客

协程驱动的系统托盘调度器：打造后台驻留任务与用户弹窗响应框架

一、引言：为什么需要系统托盘 + 协程调度？

二、目标与功能清单

三、基础托盘实现（以 Windows 为例）

四、窗口消息处理与事件绑定

五、托盘主程序初始化

六、协程任务封装：任务定时刷状态

七、定时器 Awaiter 实现

八、协程任务：周期性弹窗与状态变化

九、托盘通知弹窗（Balloon）

十、主程序入口

十一、运行效果演示

十二、可扩展功能建议

十三、适用场景示例

十四、总结

ITPub博客

协程驱动的系统托盘调度器：打造后台驻留任务与用户弹窗响应框架

一、引言：为什么需要系统托盘 + 协程调度？

二、目标与功能清单

三、基础托盘实现（以 Windows 为例）

注册托盘图标（WinAPI）

四、窗口消息处理与事件绑定

五、托盘主程序初始化

六、协程任务封装：任务定时刷状态

七、定时器 Awaiter 实现

八、协程任务：周期性弹窗与状态变化

九、托盘通知弹窗（Balloon）

十、主程序入口

十一、运行效果演示

十二、可扩展功能建议

十三、适用场景示例

十四、总结

最新文章