KDE screen edge
此接口允许客户端将操作与屏幕边缘关联。例如，通过将指针移动到屏幕边缘来显示一个 surface。
触发屏幕边缘的潜在方式由合成器策略决定。例如，合成器可以考虑当指针触及关联的屏幕边界时触发屏幕边缘。其他方式可能包括使用触摸屏或触摸板手势。
警告！此文件中描述的协议是桌面环境的实现细节。普通客户端不得使用此协议。可能会在不增加扩展主版本号的情况下添加不向后兼容的更改。
get_auto_hide_screen_edge(id: new_id<kde_auto_hide_screen_edge_v1>, border: uint<kde_screen_edge_manager_v1.border>, surface: object<wl_surface>)
参数 | 类型 | 描述 |
|---|---|---|
| id | new_id<kde_auto_hide_screen_edge_v1> | the new screen edge |
| border | uint<kde_screen_edge_manager_v1.border> | the associated screen border |
| surface | object<wl_surface> | the surface |
创建一个新的自动隐藏屏幕边缘对象，与指定的 surface 和边界关联。
创建 kde_auto_hide_screen_edge_v1 对象不会改变 surface 的可见性。必须发出 kde_auto_hide_screen_edge_v1.activate 请求才能隐藏 surface。
"border" 参数必须是有效的枚举条目，否则将引发 invalid_border 协议错误。
如果指定的 surface 没有 layer_surface 角色，将引发 invalid_role 协议错误。
error { invalid_border, invalid_role, already_constructed }
参数 | 值 | 描述 |
|---|---|---|
| invalid_border | 0 | 指定的边界值无效 |
| invalid_role | 1 | surface 具有无效的角色 |
| already_constructed | 2 | surface 已经有一个屏幕边缘 |
自动隐藏屏幕边缘对象允许隐藏 surface 并通过触发屏幕边缘使其可见。屏幕边缘默认处于非活动状态，surface 默认可见。
此接口可用于实现自动隐藏面板或 dock 等用户界面元素。
kde_auto_hide_screen_edge_v1.activate 激活屏幕边缘并隐藏 surface。可以通过触发屏幕边缘或调用 kde_auto_hide_screen_edge_v1.deactivate 使 surface 可见。
如果屏幕边缘已被触发，它不会被重新激活。客户端必须发出另一个 kde_auto_hide_screen_edge_v1.activate 请求来激活屏幕边缘。
destroy()
销毁自动隐藏屏幕边缘对象。如果屏幕边缘处于活动状态，它将被停用，surface 将变为可见。
合成器支持
Cage  | COSMIC  | GameScope  | Hyprland  | Jay | KWin  | Labwc  | Louvre  | Mir  | Muffin  | Mutter  | niri  | phoc  | river  | Sway  | Treeland  | Wayfire  | Weston  | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| kde_screen_edge_manager_v1 | x | x | x | x | x | 1 | x | x | x | x | x | x | x | x | x | x | x | x |