Method

GtkClipboardwait_for_image

since: 2.6

Declaration [src]

GdkPixbuf*
gtk_clipboard_wait_for_image (
  GtkClipboard* clipboard
)

Description [src]

Requests the contents of the clipboard as image and converts the result to a GdkPixbuf. 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.6

Return value

Type: GdkPixbuf

A newly-allocated GdkPixbuf object which must be disposed with g_object_unref(), 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 an image.).

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

The return value can be NULL.