fix: 更改 window 相关接口注释使其与最新的窗口堆叠方案适配

This commit is contained in:
2026-04-05 23:25:25 +08:00
parent 1d781d66e9
commit a89613d37d

View File

@@ -130,21 +130,20 @@ bool state_output_valid(const state_t *state, output_id_t id);
/* /*
* state 持有的 window 集合接口 * state 持有的 window 集合接口
* *
* TODO: 这组接口负责管理 state_t.windows[] 容器本身,并维护当前过渡期的 * 这组接口负责管理 state_t.windows[] 容器本身,并维护分层的堆叠顺序。
* stack_order[] 视图;后续会切换到 layer stack 为主 * 接口返回的 window 对象仅提供只读访问
* 对外只提供只读访问。
* window 的运行期可变状态必须通过专门的 state 级更新接口修改。 * window 的运行期可变状态必须通过专门的 state 级更新接口修改。
*/ */
/* /*
* TODO: 添加窗口,并将其追加到当前过渡期的 stack_order[] 顶部 * 添加窗口,并将其追加到对应堆栈顶部
* *
* info 提供 backend 已探测到的窗口基础信息 * info 提供窗口基础信息
* workspace 归属与其他策略相关字段由后续 state_window_* 接口设置。 * workspace 归属与其他策略相关字段由后续 state_window_* 接口设置。
*/ */
const window_t *state_window_add(state_t *state, const window_info_t *info); const window_t *state_window_add(state_t *state, const window_info_t *info);
const window_t *state_window_get(const state_t *state, window_id_t id); const window_t *state_window_get(const state_t *state, window_id_t id);
const window_t *state_window_at(const state_t *state, size_t index); const window_t *state_window_at(const state_t *state, size_t index);
/* TODO: 删除窗口,并同步从当前过渡期的 stack_order[] 中移除 */ /* 删除窗口,并同步将其从对应的堆叠栈中移除 */
void state_window_remove(state_t *state, window_id_t id); void state_window_remove(state_t *state, window_id_t id);
size_t state_window_count(const state_t *state); size_t state_window_count(const state_t *state);