Method

GtkClipboardset_with_data

Declaration [src]

gboolean
gtk_clipboard_set_with_data (
  GtkClipboard* clipboard,
  const GtkTargetEntry* targets,
  guint n_targets,
  GtkClipboardGetFunc get_func,
  GtkClipboardClearFunc clear_func,
  gpointer user_data
)

Description [src]

Virtually sets the contents of the specified clipboard by providing a list of supported formats for the clipboard data and a function to call to get the actual data when it is requested.

This method is not directly available to language bindings.

Parameters

targets

Type: An array of GtkTargetEntry

Array containing information about the available forms for the clipboard data.

The length of the array is specified in the n_targets argument.

The data is owned by the caller of the method.

n_targets

Type: guint

Number of elements in targets.

get_func

Type: GtkClipboardGetFunc

Function to call to get the actual clipboard data.

clear_func

Type: GtkClipboardClearFunc

When the clipboard contents are set again, this function will be called, and get_func will not be subsequently called.

user_data

Type: gpointer

User data to pass to get_func and clear_func.

The argument can be NULL.

The data is owned by the caller of the method.

Return value

Type: gboolean

TRUE if setting the clipboard data succeeded. If setting the clipboard data failed the provided callback functions will be ignored.