Method

GtkClipboardrequest_rich_text

since: 2.10

Declaration [src]

void
gtk_clipboard_request_rich_text (
  GtkClipboard* clipboard,
  GtkTextBuffer* buffer,
  GtkClipboardRichTextReceivedFunc callback,
  gpointer user_data
)

Description [src]

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 NULL 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.

Available since: 2.10

Parameters

buffer

Type: GtkTextBuffer

A GtkTextBuffer.

The data is owned by the caller of the method.

callback

Type: GtkClipboardRichTextReceivedFunc

A function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.).

user_data

Type: gpointer

User data to pass to callback.

The argument can be NULL.

The data is owned by the caller of the method.