Буферы обмена

GtkClipboardReceivedFunc ()

void
(*GtkClipboardReceivedFunc) (GtkClipboard *clipboard,
                             GtkSelectionData *selection_data,
                             gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_contents() или при сбое запроса.

GtkClipboardTextReceivedFunc ()

void
(*GtkClipboardTextReceivedFunc) (GtkClipboard *clipboard,
                                 const gchar *text,
                                 gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_text() или при сбое запроса.

GtkClipboardImageReceivedFunc ()

void
(*GtkClipboardImageReceivedFunc) (GtkClipboard *clipboard,
                                  GdkPixbuf *pixbuf,
                                  gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_image() или при сбое запроса.

С: 2.6

GtkClipboardTargetsReceivedFunc ()

void
(*GtkClipboardTargetsReceivedFunc) (GtkClipboard *clipboard,
                                    GdkAtom *atoms,
                                    gint n_atoms,
                                    gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_targets() или при сбое запроса.

С: 2.4

GtkClipboardRichTextReceivedFunc ()

void
(*GtkClipboardRichTextReceivedFunc) (GtkClipboard *clipboard,
                                     GdkAtom format,
                                     const guint8 *text,
                                     gsize length,
                                     gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_rich_text() или при сбое запроса.

С: 2.10

GtkClipboardURIReceivedFunc ()

void
(*GtkClipboardURIReceivedFunc) (GtkClipboard *clipboard,
                                gchar **uris,
                                gpointer data);

Функция, вызываемая при получении результатов gtk_clipboard_request_uris() или при сбое запроса.

С: 2.14

GtkClipboardGetFunc ()

void
(*GtkClipboardGetFunc) (GtkClipboard *clipboard,
                        GtkSelectionData *selection_data,
                        guint info,
                        gpointer user_data_or_owner);

Функция, которая будет вызвана для предоставления содержимого выделения. Если было рекламировано несколько типов данных, запрашиваемый тип можно определить из параметра info или проверив целевое поле selection_data. Если данные можно успешно преобразовать, то они должны быть сохранены в объекте selection_data, вызвав gtk_selection_data_set() (или связанные функции, такие как gtk_selection_data_set_text()). Если данные не установлены, запрашивателю будет сообщено, что попытка получить данные не удалась.

GtkClipboardClearFunc ()

void
(*GtkClipboardClearFunc) (GtkClipboard *clipboard,
                          gpointer user_data_or_owner);

Функция, которая будет вызвана при изменении или очистке содержимого буфера обмена. После вызова этого параметра user_data_or_owner больше не будет использоваться.

gtk_clipboard_get ()

GtkClipboard *
gtk_clipboard_get (GdkAtom selection);

Возвращает объект буфера обмена для данного выделения. Подробности см. в gtk_clipboard_get_for_display().

gtk_clipboard_get_for_display ()

GtkClipboard *
gtk_clipboard_get_for_display (GdkDisplay *display,
                               GdkAtom selection);

Возвращает объект буфера обмена для данного выделения. Элементы меню «Вырезать/Копировать/Вставить» и сочетания клавиш должны использовать стандартный буфер обмена, возвращаемый путём передачи GDK_SELECTION_CLIPBOARD для selection. (GDK_NONE поддерживается как синоним GDK_SELECTION_CLIPBOARD для обратной совместимости). Текущий выделенный объект или текст должен быть предоставлен в буфере обмена, идентифицированном как GDK_SELECTION_PRIMARY. Элементы меню «Вырезать/Копировать/Вставить» концептуально копируют содержимое буфера обмена GDK_SELECTION_PRIMARY в стандартный буфер обмена, т. е. они копируют выделение в то, что пользователь видит как буфер обмена.

(Передача GDK_NONE эквивалентна использованию gdk_atom_intern ("CLIPBOARD", FALSE).

См. Спецификацию буфера обмена FreeDesktop для подробного обсуждения выборов «CLIPBOARD» и «PRIMARY» в системе X window. В Win32 буфер обмена GDK_SELECTION_PRIMARY фактически игнорируется.)

Возможно иметь произвольные буферы обмена с именами; если вы изобретаете новые буферы обмена, вы должны добавлять префикс подчёркивания (поскольку ICCCM требует, чтобы атомы, отличные от стандартных, имели префикс подчёркивания), а также имя пространства имён. Например, если ваше приложение называется «Foo» и у него есть буфер обмена специального назначения, вы можете назвать его «_FOO_SPECIAL_CLIPBOARD».

С: 2.2

gtk_clipboard_get_display ()

GdkDisplay *
gtk_clipboard_get_display (GtkClipboard *clipboard);

Возвращает GdkDisplay ассоциированный с clipboard

С: 2.2

gtk_clipboard_get_default ()

GtkClipboard *
gtk_clipboard_get_default (GdkDisplay *display);

Возвращает стандартный объект буфера обмена для использования с элементами меню «Вырезать/Копировать/Вставить» и сочетаниями клавиш.

С: 3.16

gtk_clipboard_set_with_data ()

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

Виртуально устанавливает содержимое указанного буфера обмена, предоставив список поддерживаемых форматов данных буфера обмена и функцию для получения фактических данных при запросе.

[skip]

gtk_clipboard_set_with_owner ()

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

Виртуально устанавливает содержимое указанного буфера обмена, предоставив список поддерживаемых форматов данных буфера обмена и функцию для получения фактических данных при запросе.

Различие между этой функцией и gtk_clipboard_set_with_data() заключается в том, что вместо указателя общего назначения user_data передается объект GObject.

[skip]

gtk_clipboard_get_owner ()

GObject *
gtk_clipboard_get_owner (GtkClipboard *clipboard);

Если обратные вызовы содержимого буфера обмена были установлены с помощью gtk_clipboard_set_with_owner(), и gtk_clipboard_set_with_data() или gtk_clipboard_clear() не были вызваны, возвращает владельца, установленного с помощью gtk_clipboard_set_with_owner().

gtk_clipboard_clear ()

void
gtk_clipboard_clear (GtkClipboard *clipboard);

Очищает содержимое буфера обмена. Как правило, это следует делать только между вызовами gtk_clipboard_set_with_owner() или gtk_clipboard_set_with_data() и вызовом предоставленной вами clear_func. В противном случае буфер обмена может быть занят кем-то другим.

gtk_clipboard_set_text ()

void
gtk_clipboard_set_text (GtkClipboard *clipboard,
                        const gchar *text,
                        gint len);

Устанавливает содержимое буфера обмена на заданную строку UTF-8. GTK+ создаст копию текста и возьмет на себя ответственность за обработку запросов к тексту и преобразование текста в требуемый формат.

gtk_clipboard_set_image ()

void
gtk_clipboard_set_image (GtkClipboard *clipboard,
                         GdkPixbuf *pixbuf);

Устанавливает содержимое буфера обмена на заданный GdkPixbuf. GTK+ возьмет на себя ответственность за обработку запросов к изображению и преобразование изображения в требуемый формат.

С: 2.6

gtk_clipboard_request_contents ()

void
gtk_clipboard_request_contents (GtkClipboard *clipboard,
                                GdkAtom target,
                                GtkClipboardReceivedFunc callback,
                                gpointer user_data);

Запрашивает содержимое буфера обмена в качестве указанного целевого формата. Когда результаты будут получены, будет вызван предоставленный обратный вызов.

gtk_clipboard_request_text ()

void
gtk_clipboard_request_text (GtkClipboard *clipboard,
                            GtkClipboardTextReceivedFunc callback,
                            gpointer user_data);

Запрашивает содержимое буфера обмена в виде текста. Когда текст позже будет получен, он будет преобразован в UTF-8 при необходимости, и будет вызван callback.

Параметр text функции callback будет содержать полученный текст, если запрос выполнен успешно, или NULL, если произошла ошибка. Это может произойти по разным причинам, в частности, если буфер обмена был пуст или содержимое буфера обмена не удалось преобразовать в текстовый формат.

gtk_clipboard_request_image ()

void
gtk_clipboard_request_image (GtkClipboard *clipboard,
                             GtkClipboardImageReceivedFunc callback,
                             gpointer user_data);

Запрашивает содержимое буфера обмена в виде изображения. Когда изображение будет позже получено, оно будет преобразовано в GdkPixbuf, и будет вызван callback.

Параметр pixbuf функции callback будет содержать полученный GdkPixbuf, если запрос выполнен успешно, или NULL, если произошла ошибка. Это может произойти по разным причинам, в частности, если буфер обмена был пуст или содержимое буфера обмена не удалось преобразовать в изображение.

С: 2.6

gtk_clipboard_request_targets ()

void
gtk_clipboard_request_targets (GtkClipboard *clipboard,
                               GtkClipboardTargetsReceivedFunc callback,
                               gpointer user_data);

Запрашивает список поддерживаемых целевых форматов буфера обмена. Когда список будет получен, будет вызван callback.

Параметр targets функции callback будет содержать полученный список целевых форматов, если запрос выполнен успешно, или NULL, если произошла ошибка.

С: 2.4

gtk_clipboard_request_rich_text ()

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

Запрашивает содержимое буфера обмена в формате форматированного текста. Когда форматированный текст будет получен, будет вызван callback.

Параметр text функции callback будет содержать полученный форматированный текст, если запрос выполнен успешно, или NULL, если произошла ошибка. Параметр length будет содержать длину результата text. Данная функция может завершиться ошибкой по разным причинам, в частности, если буфер обмена был пуст или содержимое буфера обмена не удалось преобразовать в формат форматированного текста.

С: 2.10

gtk_clipboard_request_uris ()

void
gtk_clipboard_request_uris (GtkClipboard *clipboard,
                            GtkClipboardURIReceivedFunc callback,
                            gpointer user_data);

Запрашивает содержимое буфера обмена в формате URI. Когда URI будут получены, будет вызван callback.

Параметр uris функции callback будет содержать полученный массив URI, если запрос выполнен успешно, или NULL, если произошла ошибка. Это может произойти по разным причинам, в частности, если буфер обмена был пуст или содержимое буфера обмена не удалось преобразовать в формат URI.

С: 2.14

gtk_clipboard_wait_for_contents ()

GtkSelectionData *
gtk_clipboard_wait_for_contents (GtkClipboard *clipboard,
                                 GdkAtom target);

Запрашивает содержимое буфера обмена, используя указанный целевой формат. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

gtk_clipboard_wait_for_text ()

gchar *
gtk_clipboard_wait_for_text (GtkClipboard *clipboard);

Запрашивает содержимое буфера обмена как текст и преобразует результат в UTF-8, если необходимо. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

gtk_clipboard_wait_for_image ()

GdkPixbuf *
gtk_clipboard_wait_for_image (GtkClipboard *clipboard);

Запрашивает содержимое буфера обмена как изображение и преобразует результат в объект GdkPixbuf. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

С: 2.6

gtk_clipboard_wait_for_rich_text ()

guint8 *
gtk_clipboard_wait_for_rich_text (GtkClipboard *clipboard,
                                  GtkTextBuffer *buffer,
                                  GdkAtom *format,
                                  gsize *length);

Запрашивает содержимое буфера обмена в формате форматированного текста. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

С: 2.10

gtk_clipboard_wait_for_uris ()

gchar **
gtk_clipboard_wait_for_uris (GtkClipboard *clipboard);

Запрашивает содержимое буфера обмена в виде URI. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

С: 2.14

gtk_clipboard_wait_is_text_available ()

gboolean
gtk_clipboard_wait_is_text_available (GtkClipboard *clipboard);

Проверка наличия текста для вставки. Это делается путем запроса атома TARGETS и проверки, содержит ли он какие-либо поддерживаемые целевые форматы текста. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

Эта функция немного быстрее, чем вызов gtk_clipboard_wait_for_text(), так как ей не нужно получать фактический текст.

gtk_clipboard_wait_is_image_available ()

gboolean
gtk_clipboard_wait_is_image_available (GtkClipboard *clipboard);

Проверка наличия изображения для вставки. Это делается путем запроса атома TARGETS и проверки, содержит ли он какие-либо поддерживаемые целевые форматы изображений. Эта функция ожидает получения данных, используя основной цикл, поэтому во время ожидания могут быть обработаны события, таймауты и т. д.

Эта функция немного быстрее, чем вызов gtk_clipboard_wait_for_image(), так как ей не нужно получать фактические данные изображения.

С: 2.6

gtk_clipboard_wait_is_rich_text_available ()

gboolean
gtk_clipboard_wait_is_rich_text_available
                               (GtkClipboard *clipboard,
                                GtkTextBuffer *buffer);

Проверка наличия форматированного текста, доступного для вставки. Это делается путём запроса атома TARGETS и проверки, содержит ли он какие-либо поддерживаемые форматированные целевые объекты. Данная функция ожидает получения данных, используя основной цикл, поэтому события, таймауты и т. п. могут быть обработаны во время ожидания.

Эта функция немного быстрее, чем вызов gtk_clipboard_wait_for_rich_text(), так как ей не требуется извлечение фактического текста.

С: 2.10

gtk_clipboard_wait_is_uris_available ()

gboolean
gtk_clipboard_wait_is_uris_available (GtkClipboard *clipboard);

Проверка наличия списка URI, доступного для вставки. Это делается путём запроса атома TARGETS и проверки, содержит ли он целевые объекты URI. Эта функция ожидает получения данных, используя основной цикл, поэтому события, таймауты и т. п. могут быть обработаны во время ожидания.

Эта функция немного быстрее, чем вызов gtk_clipboard_wait_for_uris(), так как ей не требуется извлечение фактических данных URI.

С: 2.14

gtk_clipboard_wait_for_targets ()

gboolean
gtk_clipboard_wait_for_targets (GtkClipboard *clipboard,
                                GdkAtom **targets,
                                gint *n_targets);

Возвращает список целевых объектов, присутствующих в буфере обмена, или NULL если целевые объекты недоступны. Возвращаемый список необходимо освободить с помощью g_free(). Эта функция ожидает получения данных, используя основной цикл, поэтому события, таймауты и т. п. могут быть обработаны во время ожидания.

С: 2.4

gtk_clipboard_wait_is_target_available ()

gboolean
gtk_clipboard_wait_is_target_available
                               (GtkClipboard *clipboard,
                                GdkAtom target);

Проверяет, поддерживает ли буфер обмена вставку данных заданного типа. Эта функция может быть использована для определения, следует ли сделать элемент меню «Вставить» неактивным.

Если вам нужно проверить наличие текста в буфере обмена, используйте gtk_clipboard_wait_is_text_available().

С: 2.6

gtk_clipboard_set_can_store ()

void
gtk_clipboard_set_can_store (GtkClipboard *clipboard,
                             const GtkTargetEntry *targets,
                             gint n_targets);

Подсказывает, что данные буфера обмена должны быть сохранены где-то при выходе приложения или при вызове gtk_clipboard_store().

Это значение сбрасывается при изменении владельца буфера обмена. Место сохранения данных буфера обмена зависит от платформы. См. gdk_display_store_clipboard() для получения дополнительной информации.

С: 2.6

gtk_clipboard_store ()

void
gtk_clipboard_store (GtkClipboard *clipboard);

Сохраняет текущие данные буфера обмена в определённом месте, чтобы они сохранились после выхода приложения.

С: 2.6

gtk_clipboard_get_selection ()

GdkAtom
gtk_clipboard_get_selection (GtkClipboard *clipboard);

Получает селекцию, к которой относится данный буфер обмена.

С: 3.22