Memory-managed wrapper type.

Type class for types which can be safely cast to Clipboard, for instance with toClipboard.

Cast to Clipboard, for types for which this is known to be safe. For general casts, use castTo.

A convenience alias for Nothing :: Maybe Clipboard.

Clears the contents of the clipboard. Generally this should only be called between the time you call gtk_clipboard_set_with_owner() or gtk_clipboard_set_with_data(), and when the clearFunc you supplied is called. Otherwise, the clipboard may be owned by someone else.

Returns the clipboard object for the given selection. See clipboardGetForDisplay for complete details.

Returns the default clipboard object for use with cut/copy/paste menu items and keyboard shortcuts.

Since: 3.16

Gets the Display associated with clipboard

Since: 2.2

Returns the clipboard object for the given selection. Cut/copy/paste menu items and keyboard shortcuts should use the default clipboard, returned by passing GDK_SELECTION_CLIPBOARD for selection. (GDK_NONE is supported as a synonym for GDK_SELECTION_CLIPBOARD for backwards compatibility reasons.) The currently-selected object or text should be provided on the clipboard identified by GDK_SELECTION_PRIMARY. Cut/copy/paste menu items conceptually copy the contents of the GDK_SELECTION_PRIMARY clipboard to the default clipboard, i.e. they copy the selection to what the user sees as the clipboard.

(Passing GDK_NONE is the same as using gdk_atom_intern ("CLIPBOARD", FALSE).

See the FreeDesktop Clipboard Specification for a detailed discussion of the “CLIPBOARD” vs. “PRIMARY” selections under the X window system. On Win32 the GDK_SELECTION_PRIMARY clipboard is essentially ignored.)

It’s possible to have arbitrary named clipboards; if you do invent new clipboards, you should prefix the selection name with an underscore (because the ICCCM requires that nonstandard atoms are underscore-prefixed), and namespace it as well. For example, if your application called “Foo” has a special-purpose clipboard, you might call it “_FOO_SPECIAL_CLIPBOARD”.

Since: 2.2

If the clipboard contents callbacks were set with gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or clipboardClear has not subsequently called, returns the owner set by gtk_clipboard_set_with_owner().

Requests the contents of clipboard as the given target. When the results of the result are later received the supplied callback will be called.

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

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

Since: 2.6

Requests the contents of the clipboard as rich text. When the rich text is later received, callback will be called.

The text parameter to callback will contain the resulting rich text if the request succeeded, or Nothing if it failed. The length parameter will contain text’s length. This function can fail for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into rich text form.

Since: 2.10

Requests the contents of the clipboard as list of supported targets. When the list is later received, callback will be called.

The targets parameter to callback will contain the resulting targets if the request succeeded, or Nothing if it failed.

Since: 2.4

Requests the contents of the clipboard as text. When the text is later received, it will be converted to UTF-8 if necessary, and callback will be called.

The text parameter to callback will contain the resulting text if the request succeeded, or Nothing 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 text form.

Requests the contents of the clipboard as URIs. When the URIs are later received callback will be called.

The uris parameter to callback will contain the resulting array of URIs if the request succeeded, or Nothing 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 URI form.

Since: 2.14

Hints that the clipboard data should be stored somewhere when the application exits or when gtk_clipboard_store () is called.

This value is reset when the clipboard owner changes. Where the clipboard data is stored is platform dependent, see gdk_display_store_clipboard () for more information.

Since: 2.6

Sets the contents of the clipboard to the given Pixbuf. GTK+ will take responsibility for responding for requests for the image, and for converting the image into the requested format.

Since: 2.6

Sets the contents of the clipboard to the given UTF-8 string. GTK+ will make a copy of the text and take responsibility for responding for requests for the text, and for converting the text into the requested format.

Stores the current clipboard data somewhere so that it will stay around after the application has quit.

Since: 2.6

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.

Requests the contents of the clipboard as image and converts the result to a Pixbuf. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

Since: 2.6

Returns a list of targets that are present on the clipboard, or Nothing if there aren’t any targets available. The returned list must be freed with free. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

Since: 2.4

Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

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

Since: 2.14

Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported image targets. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

This function is a little faster than calling clipboardWaitForImage since it doesn’t need to retrieve the actual image data.

Since: 2.6

Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

This function is a little faster than calling clipboardWaitForRichText since it doesn’t need to retrieve the actual text.

Since: 2.10

Checks if a clipboard supports pasting data of a given type. This function can be used to determine if a “Paste” menu item should be insensitive or not.

If you want to see if there’s text available on the clipboard, use gtk_clipboard_wait_is_text_available () instead.

Since: 2.6

Test to see if there is text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported text targets. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

This function is a little faster than calling clipboardWaitForText since it doesn’t need to retrieve the actual text.

Test to see if there is a list of URIs available to be pasted This is done by requesting the TARGETS atom and checking if it contains the URI targets. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

This function is a little faster than calling clipboardWaitForUris since it doesn’t need to retrieve the actual URI data.

Since: 2.14

Type for the callback on the (unwrapped) C side.

The ::owner-change signal is emitted when GTK+ receives an event that indicates that the ownership of the selection associated with clipboard has changed.

Since: 2.6

Connect a signal handler for the “owner-change” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after clipboard #ownerChange callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_ClipboardOwnerChangeCallback.

A convenience synonym for Nothing :: Maybe ClipboardOwnerChangeCallback.

Connect a signal handler for the “owner-change” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on clipboard #ownerChange callback

Wrap a ClipboardOwnerChangeCallback into a C_ClipboardOwnerChangeCallback.