Method

GtkClipboardwait_for_uris

since: 2.14

Declaration [src]

gchar**
gtk_clipboard_wait_for_uris (
  GtkClipboard* clipboard
)

Description [src]

Requests the contents of the clipboard as URIs. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

Available since: 2.14

Return value

Type: An array of utf8

a newly-allocated `NULL`-terminated array of strings which must
be freed with g_strfreev(), or `NULL` if retrieving the
selection data failed. (This could happen for various reasons,
in particular if the clipboard was empty or if the contents of
the clipboard could not be converted into URI form.).

The array is NULL-terminated.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.

The return value can be NULL.

Each element is a NUL terminated UTF-8 string.