GdkWayland.WaylandToplevel.export_handle

### Method

# GdkWayland WaylandToplevelexport_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()`.

Note that this API depends on an unstable Wayland protocol, and thus may require changes in the future.

#### Parameters

`callback` | `GdkWaylandToplevelExported`
| Callback to call with the handle.
`user_data` | `gpointer`
| User data for `callback`.
| The argument can be `NULL`.
| The data is owned by the caller of the function.
`destroy_func` | `GDestroyNotify`
| Destroy notify for `user_data`.

#### Return value

Returns: | `gboolean`
| `TRUE` if the handle has been requested, `FALSE` if an error occurred.