Method

GtkClipboardwait_for_contents

Declaration [src]

GtkSelectionData*
gtk_clipboard_wait_for_contents (
  GtkClipboard* clipboard,
  GdkAtom target
)

Description [src]

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

Parameters

target

Type: GdkAtom

An atom representing the form into which the clipboard owner should convert the selection.

Return value

Type: GtkSelectionData

A newly-allocated GtkSelectionData object or NULL if retrieving the given target failed. If non-NULL, this value must be freed with gtk_selection_data_free() when you are finished with it.

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

The return value can be NULL.