backend: X11 后端添加获取窗口 metadata 信息方式

src/backend/x11/window.h

@@ -0,0 +1,33 @@
+#pragma once
+
+#include <xcb/xproto.h>
+
+#include "core/backend.h"
+
+/**
+ * @brief 获取窗口的 role 属性
+ * @param backend 后端实例指针
+ * @param window 目标窗口
+ * @return 返回窗口的 role 属性字符串，调用者持有其内存并负责调用 free 释放
+ */
+char *window_get_role(backend_t *backend, xcb_window_t window);
+
+/**
+ * @brief 获取窗口标题
+ * @details 获取窗口的 _NET_WM_NAME/WM_NAME 属性作为其 title
+ * @param backend 后端实例指针
+ * @param window 目标窗口
+ * @return 返回窗口标题字符串，由调用者持有其内存并负责调用 free 释放
+ */
+char *window_get_title(backend_t *backend, xcb_window_t window);
+
+/**
+ * @brief 获取窗口的 class 和 instance 信息
+ * @param backend 后端实例指针
+ * @param window 目标窗口
+ * @param class_out class 信息返回指针，调用者持有其内存并负责调用 free 释放
+ * @param instance_out instance 信息返回指针，调用者持有其内存并负责调用 free
+ * 释放
+ */
+void window_get_class(backend_t *backend, xcb_window_t window, char **class_out,
+                      char **instance_out);