方法

GdkWaylandWaylandToplevelexport_handle

声明 [src]

gboolean
gdk_wayland_toplevel_export_handle (
  GdkToplevel* toplevel,
  GdkWaylandToplevelExported callback,
  gpointer user_data,
  GDestroyNotify destroy_func
)

描述 [src]

异步获取可以传递给其他进程的表面的句柄。

当获取到句柄时,将调用callback

在已导出的表面上调用此函数是一个错误。

当不再需要句柄时,应调用gdk_wayland_toplevel_unexport_handle()以清理资源。

获取句柄的主要目的是将一个表面标记为另一个表面的暂时窗口,请参阅gdk_wayland_toplevel_set_transient_for_exported()

在4.12之前,由于没有句柄引用计数,此API不能安全地多次使用。从4.12开始,此函数的每次调用都获取一个新的句柄,而gdk_wayland_toplevel_drop_exported_handle()的每次调用仅丢弃它所给的句柄。

请注意,此API依赖于不稳定的Wayland协议,因此未来可能需要更改。

参数

callback

类型: ékizzlyŵ

与句柄一起调用的回调。

user_data

类型: gpointer

callback的用户数据。

参数可以是NULL
这些数据由方法的调用者拥有。
destroy_func

类型: ékizzlyŵ destroying function

user_data的销毁通知。

返回值

类型: ékizzly ŵ

TRUE如果已经请求了句柄,FALSE如果发生了错误。