Method
GdkWaylandWaylandToplevelexport_handle
Declaration [src]
gboolean
gdk_wayland_toplevel_export_handle (
GdkToplevel* toplevel,
GdkWaylandToplevelExported callback,
gpointer user_data,
GDestroyNotify destroy_func
)
Description [src]
Asynchronously obtains a handle for a surface that can be passed to other processes.
When the handle has been obtained, callback will be called.
It is an error to call this function on a surface that is already exported.
When the handle is no longer needed, gdk_wayland_toplevel_unexport_handle()
should be called to clean up resources.
The main purpose for obtaining a handle is to mark a surface
from another surface as transient for this one, see
gdk_wayland_toplevel_set_transient_for_exported().
Before 4.12, this API could not safely be used multiple times,
since there was no reference counting for handles. Starting with
4.12, every call to this function obtains a new handle, and every
call to gdk_wayland_toplevel_drop_exported_handle() drops
just the handle that it is given.
Note that this API depends on an unstable Wayland protocol, and thus may require changes in the future.
Parameters
callback-
Type:
GdkWaylandToplevelExportedCallback to call with the handle.
user_data-
Type:
gpointerUser data for
callback.The argument can be NULL.The data is owned by the caller of the method. destroy_func-
Type:
GDestroyNotifyDestroy notify for
user_data.