Method

GtkClipboardset_with_owner

Declaration [src]

gboolean
gtk_clipboard_set_with_owner (
  GtkClipboard* clipboard,
  const GtkTargetEntry* targets,
  guint n_targets,
  GtkClipboardGetFunc get_func,
  GtkClipboardClearFunc clear_func,
  GObject* owner
)

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.

The difference between this function and gtk_clipboard_set_with_data() is that instead of an generic user_data pointer, a GObject is passed in.

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.

owner

Type: GObject

An object that “owns” the data. This object will be passed to the callbacks when called.

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.