wlr data control

创建一个新的数据源。

创建一个可用于管理 seat 选区的数据设备。

管理器创建的所有对象将仍然有效，直到调用它们相应的销毁请求。

此请求要求合成器代表客户端将选区设置为来自源的数据。

给定的源不能在任何进一步的 set_selection 或 set_primary_selection 请求中使用。尝试使用先前使用的源是协议错误。

要取消设置选区，请将源设置为 NULL。

销毁数据设备对象。

此请求要求合成器代表客户端将主选区设置为来自源的数据。

给定的源不能在任何进一步的 set_selection 或 set_primary_selection 请求中使用。尝试使用先前使用的源是协议错误。

要取消设置主选区，请将源设置为 NULL。

如果合成器不支持主选区，将忽略此请求。

data_offer 事件引入一个新的 wlr_data_control_offer 对象，该对象随后将用于 wlr_data_control_device.selection 事件（用于常规剪贴板选区）或 wlr_data_control_device.primary_selection 事件（用于主剪贴板选区）。紧接在 wlr_data_control_device.data_offer 事件之后，新的 data_offer 对象将发出 wlr_data_control_offer.offer 事件以描述其提供的 MIME 类型。

selection 事件发送以通知客户端此设备选区的新 wlr_data_control_offer。wlr_data_control_device.data_offer 和 wlr_data_control_offer.offer 事件在此事件之前立即发送以引入数据选区对象。当设置新选区时，selection 事件发送给客户端。wlr_data_control_offer 在收到新的 wlr_data_control_offer 或 NULL 之前有效。客户端在收到此事件时必须销毁先前的选区 wlr_data_control_offer（如果有）。

第一个 selection 事件在绑定 wlr_data_control_device 对象时发送。

此数据控制对象不再有效，应由客户端销毁。

primary_selection 事件发送以通知客户端此设备主选区的新 wlr_data_control_offer。wlr_data_control_device.data_offer 和 wlr_data_control_offer.offer 事件在此事件之前立即发送以引入数据选区对象。当设置新的主选区时，primary_selection 事件发送给客户端。wlr_data_control_offer 在收到新的 wlr_data_control_offer 或 NULL 之前有效。客户端在收到此事件时必须销毁先前的主选区 wlr_data_control_offer（如果有）。

如果合成器支持主选区，第一个 primary_selection 事件在绑定 wlr_data_control_device 对象时发送。

此请求将 MIME 类型添加到向目标公布的 MIME 类型集合中。可以调用多次以提供多种类型。

在 wlr_data_control_device.set_selection 之后调用此请求是协议错误。

销毁数据源对象。

向客户端请求数据。按指定的 MIME 类型通过传递的文件描述符发送数据，然后关闭它。

此数据源不再有效。数据源已被另一个数据源替换。

客户端应清理并销毁此数据源。

要传输提供的数据，客户端发出此请求并指明它希望接收的 MIME 类型。传输通过传递的文件描述符（通常使用 pipe 系统调用创建）进行。源客户端按请求的 MIME 类型表示写入数据，然后关闭文件描述符。

接收客户端从管道的读取端读取直到 EOF，然后关闭其端，此时传输完成。

此请求可以针对不同的 MIME 类型多次发生。

销毁数据 offer 对象。

在创建 wlr_data_control_offer 对象后立即发送。每个提供的 MIME 类型一个事件。