基于XCB开发适配stalonetray的托盘应用遇窗口嵌入难题

嘿，我之前用XCB做托盘适配的时候也踩过一模一样的坑！你用Xlib的思路是对的，咱们把那套逻辑转换成XCB的写法就行，关键是要同时搞定WM_HINTS属性和EWMH的窗口类型标记，stalonetray这类托盘才会认你的窗口。给你一步步拆解：

1. 对应Xlib的XWMHints设置XCB的xcb_wm_hints_t #

Xlib里你设置的initial_state、icon_window这些，在XCB里要通过xcb_change_property把xcb_wm_hints_t结构体传给窗口的WM_HINTS属性。代码大概是这样：

// 定义并初始化wm_hints结构体
xcb_wm_hints_t wm_hints = {0};
// 标记要设置的字段：初始状态、图标窗口、窗口组
wm_hints.flags = XCB_WM_HINTS_INITIAL_STATE | XCB_WM_HINTS_ICON_WINDOW | XCB_WM_HINTS_WINDOW_GROUP;
// 对应Xlib的WithdrawnState，告诉窗口管理器初始状态为隐藏
wm_hints.initial_state = XCB_ICCCM_WM_STATE_WITHDRAWN;
// 将当前窗口设为图标窗口和窗口组（替换成你要嵌入托盘的窗口ID）
wm_hints.icon_window = your_window_id;
wm_hints.window_group = your_window_id;

// 发送属性给X服务器
xcb_change_property(
    conn,                  // 你的XCB连接实例
    XCB_PROP_MODE_REPLACE, // 替换原有属性
    your_window_id,        // 目标窗口ID
    XCB_ATOM_WM_HINTS,     // 属性名：WM_HINTS
    XCB_ATOM_WM_HINTS,     // 属性类型
    32,                    // 每个元素为32位
    sizeof(xcb_wm_hints_t)/4, // 元素个数（结构体大小除以4，因每个字段32位）
    &wm_hints
);

2. 设置EWMH的DOCK窗口类型 #

光有WM_HINTS还不够，得让窗口管理器明确知道这是个托盘dock窗口，所以要设置_NET_WM_WINDOW_TYPE为_NET_WM_WINDOW_TYPE_DOCK：

// 动态获取对应的原子（不能硬编码，必须通过X服务器查询）
xcb_intern_atom_cookie_t type_cookie = xcb_intern_atom(conn, 0, strlen("_NET_WM_WINDOW_TYPE"), "_NET_WM_WINDOW_TYPE");
xcb_intern_atom_reply_t *type_reply = xcb_intern_atom_reply(conn, type_cookie, NULL);
xcb_atom_t net_wm_window_type = type_reply->atom;

xcb_intern_atom_cookie_t dock_cookie = xcb_intern_atom(conn, 0, strlen("_NET_WM_WINDOW_TYPE_DOCK"), "_NET_WM_WINDOW_TYPE_DOCK");
xcb_intern_atom_reply_t *dock_reply = xcb_intern_atom_reply(conn, dock_cookie, NULL);
xcb_atom_t net_wm_window_type_dock = dock_reply->atom;

// 设置窗口类型为DOCK
xcb_change_property(
    conn,
    XCB_PROP_MODE_REPLACE,
    your_window_id,
    net_wm_window_type,
    XCB_ATOM_ATOM,
    32,
    1,
    &net_wm_window_type_dock
);

// 释放reply内存，避免泄漏
free(type_reply);
free(dock_reply);

3. 额外优化小技巧 #

• 固定窗口尺寸：托盘图标一般是固定大小（比如24x24），创建窗口时直接指定宽高，或用xcb_configure_window调整，避免显示异常。
• 跳过 compositor 干扰：如果窗口被 compositor 影响显示，可设置_NET_WM_BYPASS_COMPOSITOR为1，让窗口直接渲染：

xcb_intern_atom_cookie_t bypass_cookie = xcb_intern_atom(conn, 0, strlen("_NET_WM_BYPASS_COMPOSITOR"), "_NET_WM_BYPASS_COMPOSITOR");
xcb_intern_atom_reply_t *bypass_reply = xcb_intern_atom_reply(conn, bypass_cookie, NULL);
uint32_t bypass_val = 1;
xcb_change_property(conn, XCB_PROP_MODE_REPLACE, your_window_id, bypass_reply->atom, XCB_ATOM_CARDINAL, 32, 1, &bypass_val);
free(bypass_reply);

• 注意操作顺序：一定要先设置完所有属性，再调用xcb_map_window映射窗口；如果已经映射过，先执行xcb_unmap_window，设置属性后重新映射。

最后检查点 #

确保没遗漏核心步骤：WM_HINTS的三个字段（初始状态、图标窗口、窗口组）+ EWMH的DOCK类型，这俩是stalonetray识别托盘窗口的关键。我之前就是漏了WM_HINTS的窗口组设置，折腾了半天没反应😂

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