Method

GtkWidgetget_clipboard

since: 2.2

Declaration [src]

GtkClipboard*
gtk_widget_get_clipboard (
  GtkWidget* widget,
  GdkAtom selection
)

Description [src]

Returns the clipboard object for the given selection to be used with widget. widget must have a GdkDisplay associated with it, so must be attached to a toplevel window.

Available since: 2.2

Parameters

selection

Type: GdkAtom

A GdkAtom which identifies the clipboard to use. GDK_SELECTION_CLIPBOARD gives the default clipboard. Another common value is GDK_SELECTION_PRIMARY, which gives the primary X selection.

Return value

Type: GtkClipboard

The appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent for all time.

The data is owned by the instance.