KDE plasma virtual desktop

org_kde_plasma_virtual_desktop_management

版本 3

org_kde_plasma_virtual_desktop_management::get_virtual_desktop

get_virtual_desktop(id: new_id<org_kde_plasma_virtual_desktop>, desktop_id: string)

参数	类型	描述
id	new_id<org_kde_plasma_virtual_desktop>
desktop_id	string	Unique id of the desktop

获取指定桌面的 org_kde_plasma_virtual_desktop 接口

给定特定虚拟桌面的 id，获取仅表示具有该 id 的桌面的相应 org_kde_plasma_virtual_desktop。

警告！此文件中描述的协议是桌面环境的实现细节。普通客户端不得使用此协议。可能会添加向后不兼容的更改，而无需增加扩展的主版本号。

org_kde_plasma_virtual_desktop_management::request_create_virtual_desktop

request_create_virtual_desktop(name: string, position: uint)

参数	类型	描述
name	string	The user readable name we want for the desktop
position	uint	The position we want for the desktop

请求在指定位置创建新桌面

请求服务器创建一个新的虚拟桌面，并将其放置在指定位置。如果位置为零或更小，它将被放置在开头；如果位置等于或大于总数，它将被放置在末尾。

org_kde_plasma_virtual_desktop_management::request_remove_virtual_desktop

request_remove_virtual_desktop(desktop_id: string)

参数	类型	描述
desktop_id	string	Unique id of the desktop

请求删除由 id 标识的桌面

请求服务器删除一个虚拟桌面，服务器可以同意或拒绝该请求。

org_kde_plasma_virtual_desktop_management::desktop_created

desktop_created(desktop_id: string, position: uint)

参数	类型	描述
desktop_id	string	Unique id of the desktop
position	uint	Position of this desktop, to ensure the client and the server will see desktops in the same order

新桌面创建时触发

org_kde_plasma_virtual_desktop_management::desktop_removed

desktop_removed(desktop_id: string)

参数	类型	描述
desktop_id	string	Unique id of the desktop

桌面被移除时触发

org_kde_plasma_virtual_desktop_management::done

done()

已发送所有桌面信息

在绑定到桌面管理器全局对象后发送所有其他属性后，以及在 org_kde_plasma_virtual_desktop_management 和 org_kde_plasma_virtual_desktop 属性的所有更改发送后，发送此事件。

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

org_kde_plasma_virtual_desktop_management::rows

起始版本 2

rows(rows: uint)

参数	类型	描述
rows	uint	Number of rows the virtual desktops are laid out into.

org_kde_plasma_virtual_desktop

版本 3

org_kde_plasma_virtual_desktop::request_activate

request_activate()

请求激活此桌面

请求服务器将此桌面的状态设置为活动状态：服务器可以同意或拒绝该请求。这将成为系统的新"当前"虚拟桌面。

org_kde_plasma_virtual_desktop::desktop_id

desktop_id(desktop_id: string)

参数	类型	描述
desktop_id	string	Unique id of the desktop

桌面获得了 id

id 的格式由 compositor 实现决定。桌面 id 唯一标识一个虚拟桌面，并保证永远不会存在两个具有相同 id 的桌面。字符串 id 的格式取决于服务器实现。

org_kde_plasma_virtual_desktop::name

name(name: string)

参数	类型	描述
name	string	User readable descriptive name for the desktop

org_kde_plasma_virtual_desktop::activated

activated()

桌面已被激活

该桌面将成为系统的新"当前"桌面。服务器可以支持一次只有一个虚拟桌面处于活动状态，或其他组合，例如每个屏幕一个虚拟桌面处于活动状态。与此虚拟桌面关联的窗口将被显示。

org_kde_plasma_virtual_desktop::deactivated

deactivated()

此桌面不再处于活动状态

仅与此桌面关联的窗口将被隐藏。

org_kde_plasma_virtual_desktop::done

done()

已发送所有桌面信息

在绑定到桌面对象后发送所有其他属性后，以及在此之后完成的任何其他属性更改后，发送此事件。这允许将 org_kde_plasma_virtual_desktop 属性的更改视为原子操作，即使它们通过多个事件发生。

org_kde_plasma_virtual_desktop::removed

removed()

此桌面已被移除

此虚拟桌面刚刚被服务器移除：所有窗口将失去与此桌面的关联。

org_kde_plasma_virtual_desktop::position

起始版本 3

position(index: uint)

参数	类型	描述
index	uint	virtual desktop position

虚拟桌面位置

虚拟桌面在桌面列表中的位置。虚拟桌面位置在 [0, N - 1] 范围内，其中 N 是虚拟桌面的数量。

合成器支持

	Cage 0.2.0	COSMIC 1.0.0~beta.8	GameScope 3.15.14	Hyprland 0.52.1	Jay 1.12.0	KWin 6.6	Labwc 0.9.2	Louvre 2.14.1	Mir 2.26	Muffin 6.6.0	Mutter 49.2	niri 25.11	phoc 0.52	river 0.3.13	Sway 1.11	Treeland 0.8.0	Wayfire 0.9.0	Weston 14.0.2
org_kde_plasma_virtual_desktop_management	x	x	x	x	x	3	x	x	x	x	x	x	x	x	x	x	x	x

Copyright

SPDX-FileCopyrightText: 2018 Marco Martin

SPDX-License-Identifier: LGPL-2.1-or-later