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

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. В Win32 буфер обмена GDK_SELECTION_PRIMARY по существу игнорируется.)

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

С: 2.2

gtk_clipboard_get_display ()

GdkDisplay *
gtk_clipboard_get_display (GtkClipboard *clipboard);

Возвращает связанный с clipboard объект GdkDisplay.

С: 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. Эта функция ожидает получения данных с помощью основного цикла, поэтому в ожидании могут быть обработаны события, таймауты и т. п.

Since: 2.6

gtk_clipboard_wait_for_rich_text ()

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

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

Since: 2.10

gtk_clipboard_wait_for_uris ()

gchar **
gtk_clipboard_wait_for_uris (GtkClipboard *clipboard);

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

Since: 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