Treeland foreign toplevel manager

表示客户端不再希望接收新顶层的事件。但是合成器可能会进一步发出 toplevel_created 事件，直到发出 finished 事件。

客户端在发送此请求后不得再发送任何请求。

每当创建新的顶层窗口时发出此事件。对所有顶层都会发出此事件，无论创建它们的应用程序是什么。

顶层的所有初始详细信息（标题、app_id、状态等）将在此事件之后立即通过 treeland_foreign_toplevel_handle_v1 中的相应事件发送。

此事件表示合成器已完成向 treeland_foreign_toplevel_manager_v1 发送事件。服务器将在发送此请求后立即销毁该对象，因此它将变为无效，客户端应释放与其关联的任何资源。

请求最大化顶层。如果最大化状态实际发生变化，将通过 state 事件表示。

请求取消最大化顶层。如果最大化状态实际发生变化，将通过 state 事件表示。

请求最小化顶层。如果最小化状态实际发生变化，将通过 state 事件表示。

请求取消最小化顶层。如果最小化状态实际发生变化，将通过 state 事件表示。

请求在给定 seat 上激活此顶层。不保证顶层将实际被激活。

向顶层发送关闭自身的请求。合成器通常会使用特定于 shell 的方法来执行此请求，例如发送 xdg_toplevel.close 事件。但这不保证顶层将实际被销毁。如果发生这种情况，将发出 treeland_foreign_toplevel_handle_v1.closed 事件。

此请求中指定的表面矩形对应于使用此协议的应用程序表示给定顶层的位置。合成器可以将其用作某些操作的提示，例如最小化。但客户端不需要设置此值，在这种情况下，合成器可以自由决定某个默认值。

如果客户端指定了多个矩形，则只考虑最后一个。

尺寸以表面局部坐标给出。 设置 width=height=0 会移除已设置的矩形。

销毁 treeland_foreign_toplevel_handle_v1 对象。

当客户端不再想使用该顶层或在 closed 事件之后以最终确定对象的销毁时，应调用此请求。

请求在给定输出上全屏显示顶层。如果全屏状态和/或顶层可见的输出实际发生变化，将通过 state 和 output_enter/leave 事件表示。

output 参数只是对合成器的提示。此外，如果 output 为 NULL，合成器应决定顶层将在哪个输出上全屏显示（如果有的话）。

请求取消全屏显示顶层。如果全屏状态实际发生变化，将通过 state 事件表示。

当合成器设置了此窗口所属的进程 ID 时发送此事件。应在发送 initial_state 之前设置一次。

每当顶层的标题更改时发出此事件。

每当顶层的 app-id 更改时发出此事件。

每个顶层及其句柄的标识符必须是唯一的。两个不同的顶层不能具有相同的标识符。此标识符仅在顶层映射期间有效。如果顶层未映射，标识符不得重用。合成器不得重用标识符，以确保在进程之间共享标识符时不会出现竞争。

每当顶层在给定输出上变得可见时发出此事件。顶层可能在多个输出上可见。

每当顶层在给定输出上不再可见时发出此事件。保证在此事件之前已发出具有相同输出的 entered-output 事件。

在 treeland_foreign_toplevel_handle_v1 创建后以及每次顶层状态更改时（无论是由于合成器操作还是此协议中的请求）立即发出此事件。

在发送完顶层状态的所有更改后发送此事件。

这允许将 treeland_foreign_toplevel_handle_v1 属性的更改视为原子性的，即使它们通过多个事件发生。

此事件表示顶层已被销毁。保证不会再有此 treeland_foreign_toplevel_handle_v1 的任何事件。顶层本身变为惰性，因此除了 destroy 请求外，任何请求都将被忽略。

每当顶层的父级更改时发出此事件。

当父句柄被客户端销毁时不会发出事件。

顶层可以具有的不同状态。这些与 xdg-toplevel 中定义的同名状态具有相同的含义。

X 和 Y 相对于 relative_surface。surfaces wl_array 是标识符。

关闭预览框。

销毁上下文对象。

鼠标进入预览框后发送此事件。

鼠标离开预览框后发送此事件。