Method

GtkClipboardrequest_image

since: 2.6

Declaration [src]

void
gtk_clipboard_request_image (
  GtkClipboard* clipboard,
  GtkClipboardImageReceivedFunc callback,
  gpointer user_data
)

Description [src]

Requests the contents of the clipboard as image. When the image is later received, it will be converted to a GdkPixbuf, and callback will be called.

The pixbuf parameter to callback will contain the resulting GdkPixbuf if the request succeeded, or NULL if it 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.

Available since: 2.6

Parameters

callback

Type: GtkClipboardImageReceivedFunc

A function to call when the image is received, or the retrieval fails. (It will always be called one way or the other.).

user_data

Type: gpointer

User data to pass to callback.

The argument can be NULL.

The data is owned by the caller of the method.