Wiki
Задать вопрос на форуме...

prev

up

home

gtk+ reference manual

next

top  |  description  |  object hierarchy  |  properties  |  signals

gtktextbuffer

gtktextbuffer — хранение текста с атрибутами для отображения в gtktextview

краткое описание

#include <gtk/gtk.h>


            gtktextbuffer;
gtktextbuffer* gtk_text_buffer_new          (gtktexttagtable *table);
gint        gtk_text_buffer_get_line_count  (gtktextbuffer *buffer);

gint        gtk_text_buffer_get_char_count  (gtktextbuffer *buffer);
gtktexttagtable* gtk_text_buffer_get_tag_table
                                            (gtktextbuffer *buffer);
void        gtk_text_buffer_insert          (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len);
void        gtk_text_buffer_insert_at_cursor

                                            (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len);
gboolean    gtk_text_buffer_insert_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             gboolean default_editable);

gboolean    gtk_text_buffer_insert_interactive_at_cursor
                                            (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len,
                                             gboolean default_editable);
void        gtk_text_buffer_insert_range    (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

gboolean    gtk_text_buffer_insert_range_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean default_editable);
void        gtk_text_buffer_insert_with_tags

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             gtktexttag *first_tag,
                                             ...);
void        gtk_text_buffer_insert_with_tags_by_name

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             const gchar *first_tag_name,
                                             ...);
void        gtk_text_buffer_delete          (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);

gboolean    gtk_text_buffer_delete_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *start_iter,
                                             gtktextiter *end_iter,
                                             gboolean default_editable);

gboolean    gtk_text_buffer_backspace       (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gboolean interactive,
                                             gboolean default_editable);
void        gtk_text_buffer_set_text        (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len);

gchar*      gtk_text_buffer_get_text        (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean include_hidden_chars);

gchar*      gtk_text_buffer_get_slice       (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean include_hidden_chars);
void        gtk_text_buffer_insert_pixbuf   (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gdkpixbuf *pixbuf);
void        gtk_text_buffer_insert_child_anchor

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextchildanchor *anchor);
gtktextchildanchor* gtk_text_buffer_create_child_anchor
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter);

gtktextmark* gtk_text_buffer_create_mark    (gtktextbuffer *buffer,
                                             const gchar *mark_name,
                                             const gtktextiter *where,
                                             gboolean left_gravity);
void        gtk_text_buffer_move_mark       (gtktextbuffer *buffer,
                                             gtktextmark *mark,
                                             const gtktextiter *where);
void        gtk_text_buffer_move_mark_by_name

                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *where);
void        gtk_text_buffer_delete_mark     (gtktextbuffer *buffer,
                                             gtktextmark *mark);
void        gtk_text_buffer_delete_mark_by_name

                                            (gtktextbuffer *buffer,
                                             const gchar *name);
gtktextmark* gtk_text_buffer_get_mark       (gtktextbuffer *buffer,
                                             const gchar *name);

gtktextmark* gtk_text_buffer_get_insert     (gtktextbuffer *buffer);
gtktextmark* gtk_text_buffer_get_selection_bound
                                            (gtktextbuffer *buffer);

gboolean    gtk_text_buffer_get_has_selection
                                            (gtktextbuffer *buffer);
void        gtk_text_buffer_place_cursor    (gtktextbuffer *buffer,
                                             const gtktextiter *where);
void        gtk_text_buffer_select_range    (gtktextbuffer *buffer,
                                             const gtktextiter *ins,
                                             const gtktextiter *bound);
void        gtk_text_buffer_apply_tag       (gtktextbuffer *buffer,
                                             gtktexttag *tag,
                                             const gtktextiter *start,
                                             const gtktextiter *end);
void        gtk_text_buffer_remove_tag      (gtktextbuffer *buffer,
                                             gtktexttag *tag,
                                             const gtktextiter *start,
                                             const gtktextiter *end);
void        gtk_text_buffer_apply_tag_by_name

                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *start,
                                             const gtktextiter *end);
void        gtk_text_buffer_remove_tag_by_name
                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *start,
                                             const gtktextiter *end);
void        gtk_text_buffer_remove_all_tags (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

gtktexttag* gtk_text_buffer_create_tag      (gtktextbuffer *buffer,
                                             const gchar *tag_name,
                                             const gchar *first_property_name,
                                             ...);
void        gtk_text_buffer_get_iter_at_line_offset
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number,
                                             gint char_offset);
void        gtk_text_buffer_get_iter_at_offset

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint char_offset);
void        gtk_text_buffer_get_iter_at_line
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number);
void        gtk_text_buffer_get_iter_at_line_index

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number,
                                             gint byte_index);
void        gtk_text_buffer_get_iter_at_mark
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextmark *mark);
void        gtk_text_buffer_get_iter_at_child_anchor

                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextchildanchor *anchor);
void        gtk_text_buffer_get_start_iter  (gtktextbuffer *buffer,
                                             gtktextiter *iter);
void        gtk_text_buffer_get_end_iter    (gtktextbuffer *buffer,
                                             gtktextiter *iter);
void        gtk_text_buffer_get_bounds      (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);

gboolean    gtk_text_buffer_get_modified    (gtktextbuffer *buffer);
void        gtk_text_buffer_set_modified    (gtktextbuffer *buffer,
                                             gboolean setting);

gboolean    gtk_text_buffer_delete_selection
                                            (gtktextbuffer *buffer,
                                             gboolean interactive,
                                             gboolean default_editable);
void        gtk_text_buffer_paste_clipboard (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard,
                                             gtktextiter *override_location,
                                             gboolean default_editable);
void        gtk_text_buffer_copy_clipboard  (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);
void        gtk_text_buffer_cut_clipboard   (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard,
                                             gboolean default_editable);

gboolean    gtk_text_buffer_get_selection_bounds
                                            (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);
void        gtk_text_buffer_begin_user_action

                                            (gtktextbuffer *buffer);
void        gtk_text_buffer_end_user_action (gtktextbuffer *buffer);
void        gtk_text_buffer_add_selection_clipboard
                                            (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);
void        gtk_text_buffer_remove_selection_clipboard

                                            (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);

enum        gtktextbuffertargetinfo;
gboolean    (*gtktextbufferdeserializefunc) (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gtktextiter *iter,
                                             const guint8 *data,
                                             gsize length,
                                             gboolean create_tags,
                                             gpointer user_data,
                                             gerror **error);

gboolean    gtk_text_buffer_deserialize     (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gdkatom format,
                                             gtktextiter *iter,
                                             const guint8 *data,
                                             gsize length,
                                             gerror **error);

gboolean    gtk_text_buffer_deserialize_get_can_create_tags
                                            (gtktextbuffer *buffer,
                                             gdkatom format);
void        gtk_text_buffer_deserialize_set_can_create_tags
                                            (gtktextbuffer *buffer,
                                             gdkatom format,
                                             gboolean can_create_tags);

gtktargetlist* gtk_text_buffer_get_copy_target_list
                                            (gtktextbuffer *buffer);
gdkatom*    gtk_text_buffer_get_deserialize_formats
                                            (gtktextbuffer *buffer,
                                             gint *n_formats);

gtktargetlist* gtk_text_buffer_get_paste_target_list
                                            (gtktextbuffer *buffer);
gdkatom*    gtk_text_buffer_get_serialize_formats
                                            (gtktextbuffer *buffer,
                                             gint *n_formats);

gdkatom     gtk_text_buffer_register_deserialize_format
                                            (gtktextbuffer *buffer,
                                             const gchar *mime_type,
                                             gtktextbufferdeserializefunc function,
                                             gpointer user_data,
                                             gdestroynotify user_data_destroy);

gdkatom     gtk_text_buffer_register_deserialize_tagset
                                            (gtktextbuffer *buffer,
                                             const gchar *tagset_name);
gdkatom     gtk_text_buffer_register_serialize_format
                                            (gtktextbuffer *buffer,
                                             const gchar *mime_type,
                                             gtktextbufferserializefunc function,
                                             gpointer user_data,
                                             gdestroynotify user_data_destroy);

gdkatom     gtk_text_buffer_register_serialize_tagset
                                            (gtktextbuffer *buffer,
                                             const gchar *tagset_name);
guint8*     (*gtktextbufferserializefunc)   (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gsize *length,
                                             gpointer user_data);

guint8*     gtk_text_buffer_serialize       (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gdkatom format,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gsize *length);
void        gtk_text_buffer_unregister_deserialize_format

                                            (gtktextbuffer *buffer,
                                             gdkatom format);
void        gtk_text_buffer_unregister_serialize_format
                                            (gtktextbuffer *buffer,
                                             gdkatom format);

иерархия объектов

  gobject
   +----gtktextbuffer

свойства

  "copy-target-list"     gtktargetlist         : read
  "cursor-position"      gint                  : read
  "has-selection"        gboolean              : read
  "paste-target-list"    gtktargetlist         : read
  "tag-table"            gtktexttagtable       : read / write / construct only
  "text"                 gchararray            : read / write

сигналы

"apply-tag" void        user_function      (gtktextbuffer *textbuffer,
                                            gtktexttag    *arg1,
                                            gtktextiter   *arg2,
                                            gtktextiter   *arg3,
                                            gpointer       user_data)       : run last
"begin-user-action"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last
"changed"   void        user_function      (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last
"delete-range"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gtktextiter   *arg2,
                                            gpointer       user_data)       : run last
"end-user-action"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last
"insert-child-anchor"
            void        user_function      (gtktextbuffer      *textbuffer,
                                            gtktextiter        *arg1,
                                            gtktextchildanchor *arg2,
                                            gpointer            user_data)       : run last
"insert-pixbuf"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gdkpixbuf     *arg2,
                                            gpointer       user_data)       : run last
"insert-text"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gchar         *arg2,
                                            gint           arg3,
                                            gpointer       user_data)       : run last
"mark-deleted"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gtktextmark   *arg1,
                                            gpointer       user_data)       : run last
"mark-set"  void        user_function      (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gtktextmark   *arg2,
                                            gpointer       user_data)       : run last
"modified-changed"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last
"remove-tag"
            void        user_function      (gtktextbuffer *textbuffer,
                                            gtktexttag    *arg1,
                                            gtktextiter   *arg2,
                                            gtktextiter   *arg3,
                                            gpointer       user_data)       : run last

описание

для начала вы можете прочесть text widget conceptual overview который даёт краткое описание всех объектов и типов данных связанных с текстовыми виджетами и как они взаимодействуют.

детали

gtktextbuffer

typedef struct _gtktextbuffer gtktextbuffer;

gtk_text_buffer_new ()

gtktextbuffer* gtk_text_buffer_new          (gtktexttagtable *table);

создаёт новый текстовый буфер.

table :

таблица тегов, или null для создания новой

возвращает :

новый текстовый буфер

gtk_text_buffer_get_line_count ()

gint        gtk_text_buffer_get_line_count  (gtktextbuffer *buffer);

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

buffer :

gtktextbuffer

возвращает :

количество строк в буфере

gtk_text_buffer_get_char_count ()

gint        gtk_text_buffer_get_char_count  (gtktextbuffer *buffer);

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

buffer :

gtktextbuffer

возвращает :

количество символов в буфере

gtk_text_buffer_get_tag_table ()

gtktexttagtable* gtk_text_buffer_get_tag_table
                                            (gtktextbuffer *buffer);

выдаёт gtktexttagtable связанный с этим буфером.

buffer :

gtktextbuffer

возвращает :

буферная таблица тегов

gtk_text_buffer_insert ()

void        gtk_text_buffer_insert          (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len);

вставляет len байт text в позицию iter. если len это -1, text должен быть nul-terminated и будет вставлен полностью. издаёт сигнал "insert_text"; вставка фактически происходит в обработчике для этого сигнала по умолчанию. iter недействителен когда происходит вставка (потому что содержимое буфера изменяется), но по умолчанию обработчик сигнала подтверждает эту точку для завершения вставки.

buffer :

gtktextbuffer

iter :

позиция в буфере

text :

текст для вставки в формате utf-8

len :

длина текста в байтах, или -1

gtk_text_buffer_insert_at_cursor ()

void        gtk_text_buffer_insert_at_cursor
                                            (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len);

простой вызов gtk_text_buffer_insert(), использует текущую позицию курсора как точку для вставки.

buffer :

gtktextbuffer

text :

текст в формате utf-8

len :

длина текста, в байтах

gtk_text_buffer_insert_interactive ()

gboolean    gtk_text_buffer_insert_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             gboolean default_editable);

как gtk_text_buffer_insert(), но вставка не происходит если iter в недоступном для редактирования участке буфера. обычно нужно предотвращать вставку в не редактируемые участки, если вставка результат действия пользователя (интерактивно).

default_editable указывает редактируемость текста который не имеет тега влияющего на свойство редактируемости применяемого к нему. обычно результат gtk_text_view_get_editable() соответствует этому.

buffer :

gtktextbuffer

iter :

позиция в buffer

text :

текст в кодировке utf-8

len :

длина текста в байтах, или -1

default_editable :

редактируемость буфера по умолчанию

возвращает :

вставлен ли текст

gtk_text_buffer_insert_interactive_at_cursor ()

gboolean    gtk_text_buffer_insert_interactive_at_cursor
                                            (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len,
                                             gboolean default_editable);

вызывает gtk_text_buffer_insert_interactive() в позиции курсора.

default_editable указывает редактируемость текста который не имеет тега влияющего на свойство редактируемости применяемого к нему. обычно результат gtk_text_view_get_editable() соответствует этому.

buffer :

gtktextbuffer

text :

текст в кодировке utf-8

len :

длина текста в байтах, или -1

default_editable :

редактируемость буфера по умолчанию

возвращает :

вставлен ли текст

gtk_text_buffer_insert_range ()

void        gtk_text_buffer_insert_range    (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

копирует текст, теги и изображения в промежутке между start и end (порядок start и end не имеет значения) и вставляет копию в iter. используется вместо простого получения/вставки текста потому что это позволяет сохранить изображения и теги. если start и end находятся в буфере отличном от buffer, два буфера должны использовать совместно таблицу тегов.

осуществляет через эмиссию insert_text и apply_tag сигналов.

buffer :

gtktextbuffer

iter :

позиция в buffer

start :

позиция в gtktextbuffer

end :

другая позиция в том же буфере где start

gtk_text_buffer_insert_range_interactive ()

gboolean    gtk_text_buffer_insert_range_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean default_editable);

тоже самое как gtk_text_buffer_insert_range(), но не делает ничего если точка вставки нередактируема. параметр default_editable указывает редактируем ли текст в позиции iter, если нет тегов включающих iter влияющих на редактируемость. обычно результат соответствует результату gtk_text_view_get_editable().

buffer :

gtktextbuffer

iter :

позиция в buffer

start :

позиция в gtktextbuffer

end :

другая позиция в том же буфере где start

default_editable :

редактируемость буфера по умолчанию

возвращает :

была ли вставка возможна в iter

gtk_text_buffer_insert_with_tags ()

void        gtk_text_buffer_insert_with_tags
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             gtktexttag *first_tag,
                                             ...);

вставляет текст text в buffer в позицию iter, применяя список тегов к вновь вставленному тексту. последний тег должен быть определен null для завершения списка. эквивалент для вызова gtk_text_buffer_insert(), затем gtk_text_buffer_apply_tag() на вставленном тексте; gtk_text_buffer_insert_with_tags() это просто удобная функция.

buffer :

gtktextbuffer

iter :

итератор в buffer

text :

utf-8 текст

len :

длина text, или -1

first_tag :

первый тег для применения к text

... :

null-завершенный список применяемых тегов

gtk_text_buffer_insert_with_tags_by_name ()

void        gtk_text_buffer_insert_with_tags_by_name
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             const gchar *text,
                                             gint len,
                                             const gchar *first_tag_name,
                                             ...);

тоже самое как gtk_text_buffer_insert_with_tags(), но позволяет вставить имя тега вместо объектов тега.

buffer :

gtktextbuffer

iter :

позиция в buffer

text :

utf-8 текст

len :

длина text, или -1

first_tag_name :

имя тега для применения к text

... :

имена тегов

gtk_text_buffer_delete ()

void        gtk_text_buffer_delete          (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);

удаляет текст между start и end. порядок start и end не имеет значения; gtk_text_buffer_delete() будет перестраивать их. эта функция фактически издаёт сигнал "delete_range", а обработчик по умолчанию для этого сигнала удаляет текст. поскольку буфер изменяется, все нереализованные итераторы становятся недопустимы после вызова этой функции; однако, start и end будут пере инициализированы для указания размещения удаленного текста.

buffer :

gtktextbuffer

start :

позиция в buffer

end :

другая позиция в buffer

gtk_text_buffer_delete_interactive ()

gboolean    gtk_text_buffer_delete_interactive
                                            (gtktextbuffer *buffer,
                                             gtktextiter *start_iter,
                                             gtktextiter *end_iter,
                                             gboolean default_editable);

удаляет весь допустимый для редактирования текст в указанном диапазоне. вызывает gtk_text_buffer_delete() для каждого доступного для редактирования участка [start,end]. start и end повторно утверждаются для указания места последнего удаленного диапазона, или сброшены если текст не был удалён.

buffer :

gtktextbuffer

start_iter :

начало диапазона для удаления

end_iter :

конец диапазона

default_editable :

редактируем ли буфер по умолчанию

возвращает :

удален ли реально некоторый текст

gtk_text_buffer_backspace ()

gboolean    gtk_text_buffer_backspace       (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gboolean interactive,
                                             gboolean default_editable);

выполняет соответствующее действие как если пользователь нажмет на клавишу delete в позиции курсора определённой iter. обычно удаляется единственный символ, но когда объединяются включённые акценты, может быть удалено больше чем один символ, а когда предварительно составленный символ и акцент объединены, удаляется меньше одного символа.

поскольку буфер изменён, все не выполненные итераторы становятся не доступны после вызова этой функции; однако, iter будет пере-инициализирован для указания места где был удалён текст.

buffer :

gtktextbuffer

iter :

позиция в buffer

interactive :

вызвано ли удаление взаимодействием с пользователем

default_editable :

редактируем ли буфер по умолчанию

возвращает :

true если буфер был модифицирован

начиная с версии 2.6

gtk_text_buffer_set_text ()

void        gtk_text_buffer_set_text        (gtktextbuffer *buffer,
                                             const gchar *text,
                                             gint len);

удаляет текущеме содержимое buffer, и вставляет вместо него text. если len равен -1, text должен быть nul-завершённый. text должен быть в кодировке utf-8.

buffer :

gtktextbuffer

text :

utf-8 текст для вставки

len :

длина текста в байтах

gtk_text_buffer_get_text ()

gchar*      gtk_text_buffer_get_text        (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean include_hidden_chars);

возвращает текст в диапазон [start,end]. исключает не-отображаемый текст (текст маркированный тегами устанавливающими свойство невидимости) если include_hidden_chars равен false. не включая символы представляющие изображения, таким образом перечень байт и символов в возвращаемой строке не соответствует байтам и символам в буфере. противоположно действию gtk_text_buffer_get_slice().

buffer :

gtktextbuffer

start :

начало диапазона

end :

конец диапазона

include_hidden_chars :

включён ли невидимый текст

возвращает :

строка utf-8

gtk_text_buffer_get_slice ()

gchar*      gtk_text_buffer_get_slice       (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gboolean include_hidden_chars);

возвращает текст в диапазоне [start,end]. исключает не-отображаемый текст (текст маркированный тегами устанавливающими свойство невидимости) если include_hidden_chars равен fals. возвращаемая строка включает символ 0xfffc каждый раз когда буфер содержит встроенное изображение, таким образом перечень байт и символов внутри возвращаемой строки соответствует перечню байт и символов буфера. противоположно gtk_text_buffer_get_text(). помните, символ 0xfffc может располагать также и в обычном тексте, поэтому он не является надёжным индикатором изображения или виджетов в буфере.

buffer :

gtktextbuffer

start :

начало диапазона

end :

конец диапазона

include_hidden_chars :

включён ли невидимый текст

возвращает :

строка utf-8

gtk_text_buffer_insert_pixbuf ()

void        gtk_text_buffer_insert_pixbuf   (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gdkpixbuf *pixbuf);

вставляет изображение в текстовый буфер в позицию iter. изображение считается как один символ в подсчете символов, а когда определяется контекст буфера как строка, будет представлено как символ unicode "object replacement character" 0xfffc. помните, "slice" варианты определения частей буфера как строки включают этот символ для изображений, но "text" варианты нет. например смотрите gtk_text_buffer_get_slice() и gtk_text_buffer_get_text().

buffer :

gtktextbuffer

iter :

положение для вставки изображения

pixbuf :

gdkpixbuf

gtk_text_buffer_insert_child_anchor ()

void        gtk_text_buffer_insert_child_anchor
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextchildanchor *anchor);

вставляет дочерний виджет якорь в текстовый буфер в положение iter. якорь считается как единственный символ в счете символов, а когда определяется контекст буфера как строка, будет представлен как символ unicode "object replacement character" 0xfffc. помните, "slice" варианты определения частей буфера как строки включают этот символ для дочерних якорей, но "text" варианты нет. смотрите gtk_text_buffer_get_slice() и gtk_text_buffer_get_text(). рассматривайте gtk_text_buffer_create_child_anchor() как более удобную альтернативу этой функции. буфер создаёт ссылки для якоря, поэтому вы можете сбрасывать их после вставки.

buffer :

gtktextbuffer

iter :

положение вставляемого якоря

anchor :

gtktextchildanchor

gtk_text_buffer_create_child_anchor ()

gtktextchildanchor* gtk_text_buffer_create_child_anchor
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter);

это удобная функция просто создаёт дочерний якорь с помощью gtk_text_child_anchor_new() и вставляет его в буфер с помощью gtk_text_buffer_insert_child_anchor(). новый якорь принадлежит буферу; не возвращается количество для вызывающего gtk_text_buffer_create_child_anchor().

buffer :

gtktextbuffer

iter :

расположение в буфере

возвращает :

созданный дочерний якорь

gtk_text_buffer_create_mark ()

gtktextmark* gtk_text_buffer_create_mark    (gtktextbuffer *buffer,
                                             const gchar *mark_name,
                                             const gtktextiter *where,
                                             gboolean left_gravity);

создаёт маркер в позиции where. если mark_name равен null, маркер без имени; иначе, маркеру присваивается имя с помощью gtk_text_buffer_get_mark(). если маркер имеет левое притяжение (left gravity), а текст вставляется в текущеме положение маркера, маркер будет перемещён влево от вновь вставленного текста. если маркер имеет правое притяжение (left_gravity = false), маркер перемещается в право от вновь вставленного текста. при стандартном с лево на право (left-to-right) курсоре маркер с правым притяжением (когда вы печатаете, курсор остаётся справа от вашего ввода).

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

издаёт сигнал "mark_set" как уведомление о начальном размещении маркера.

buffer :

gtktextbuffer

mark_name :

имя для маркера, или null

where :

положение для маркера

left_gravity :

имеет ли маркер левое притяжение

возвращает :

новый объект gtktextmark

gtk_text_buffer_move_mark ()

void        gtk_text_buffer_move_mark       (gtktextbuffer *buffer,
                                             gtktextmark *mark,
                                             const gtktextiter *where);

перемещает mark в новое положение where. издаёт сигнал "mark_set" как уведомление о переещении.

buffer :

gtktextbuffer

mark :

gtktextmark

where :

новое положение для mark в buffer

gtk_text_buffer_move_mark_by_name ()

void        gtk_text_buffer_move_mark_by_name
                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *where);

перемещает маркер с именем name (должно существовать) в положение where. детали смотрите в gtk_text_buffer_move_mark().

buffer :

gtktextbuffer

name :

имя маркера

where :

новое положение для маркера

gtk_text_buffer_delete_mark ()

void        gtk_text_buffer_delete_mark     (gtktextbuffer *buffer,
                                             gtktextmark *mark);

удаляет mark. удаляет ссылки на маркер находящиеся в буфере, поэтому если вы не вызвали g_object_ref() на маркере, он будет освобожден. даже если маркер не освобождён, большинство операций с mark будут невозможны. восстановление маркера не возможно. gtk_text_mark_get_deleted() возвращает true после вызова этой функции на маркере; gtk_text_mark_get_deleted() указывает что маркер больше не размещается в буфере. сигнал "mark_deleted" издаётся как уведомление после удаления маркера.

buffer :

gtktextbuffer

mark :

gtktextmark в buffer

gtk_text_buffer_delete_mark_by_name ()

void        gtk_text_buffer_delete_mark_by_name
                                            (gtktextbuffer *buffer,
                                             const gchar *name);

удаляет маркер с именем name; маркер должен существовать. детали смотрите в gtk_text_buffer_delete_mark().

buffer :

gtktextbuffer

name :

имя маркера в buffer

gtk_text_buffer_get_mark ()

gtktextmark* gtk_text_buffer_get_mark       (gtktextbuffer *buffer,
                                             const gchar *name);

возвращает маркер с именем name в буфере buffer, или null если в буфере нет такого маркера.

buffer :

gtktextbuffer

name :

имя маркера

возвращает :

gtktextmark, или null

gtk_text_buffer_get_insert ()

gtktextmark* gtk_text_buffer_get_insert     (gtktextbuffer *buffer);

возвращает маркер который представляет курсор (точка вставки). эквивалентно вызову gtk_text_buffer_get_mark() для получения маркера с именем "insert", но более эффективна и требует меньше ввода.

buffer :

gtktextbuffer

возвращает :

маркер точки вставки

gtk_text_buffer_get_selection_bound ()

gtktextmark* gtk_text_buffer_get_selection_bound
                                            (gtktextbuffer *buffer);

возвращает маркер представляющий границы выделения. эквивалентно вызову gtk_text_buffer_get_mark() для получения маркера с именем "selection_bound", но более эффективна и требует меньше ввода.

текущий выделенный текст в buffer, это область между "selection_bound" и "insert" маркерами. если "selection_bound" и "insert" одно и тоже, то когда нет текущемго выделения. gtk_text_buffer_get_selection_bounds() другая удобная функция для обработки выделения, если вам просто нужно знать есть ли выделение и каковы его границы.

buffer :

gtktextbuffer

возвращает :

маркер границы выделения

gtk_text_buffer_get_has_selection ()

gboolean    gtk_text_buffer_get_has_selection
                                            (gtktextbuffer *buffer);

указывает имеет ли некоторый текст текущеме выделение.

buffer :

gtktextbuffer

возвращает :

true если есть выделенный текст

начиная с версии 2.10

gtk_text_buffer_place_cursor ()

void        gtk_text_buffer_place_cursor    (gtktextbuffer *buffer,
                                             const gtktextiter *where);

эта функция одновременно перемещает маркеры "insert" и "selection_bound". если вы перемещаете их в два этапа с помощью gtk_text_buffer_move_mark(), вы будете временно выделять область между старым и новым положением, что может быть очень не эффективно, так как временно-выбранная область будет вынужденно пересчитываться. эта функция перемещает их как объединение, которое может быть оптимизировано.

buffer :

gtktextbuffer

where :

где помещается курсор

gtk_text_buffer_select_range ()

void        gtk_text_buffer_select_range    (gtktextbuffer *buffer,
                                             const gtktextiter *ins,
                                             const gtktextiter *bound);

эта функция одновременно перемещает маркеры "insert" и "selection_bound". если вы перемещаете их в два этапа с помощью gtk_text_buffer_move_mark(), вы будете временно выделять область между старым и новым положением, что может быть очень не эффективно, так как временно-выбранная область будет вынужденно пересчитываться. эта функция перемещает их как объединение, которое может быть оптимизировано.

buffer :

gtktextbuffer

ins :

куда помещать "insert" маркер

bound :

куда помещать "selection_bound" маркер

начиная с версии 2.4

gtk_text_buffer_apply_tag ()

void        gtk_text_buffer_apply_tag       (gtktextbuffer *buffer,
                                             gtktexttag *tag,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

издаёт сигнал "apply_tag" в buffer. по умолчанию обработчик для сигнала применяет tag для данной области. start и end могут быть не упорядочены.

buffer :

gtktextbuffer

tag :

gtktexttag

start :

один конец области для отметки

end :

другой конец области для отметки

gtk_text_buffer_remove_tag ()

void        gtk_text_buffer_remove_tag      (gtktextbuffer *buffer,
                                             gtktexttag *tag,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

издаёт сигнал "remove_tag". по умолчанию обработчик сигнала удалит все теги соответствующие tag из данной области. start и end могут быть не упорядочены.

buffer :

gtktextbuffer

tag :

gtktexttag

start :

один конец области

end :

другой конец области

gtk_text_buffer_apply_tag_by_name ()

void        gtk_text_buffer_apply_tag_by_name
                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

вызывает gtk_text_tag_table_lookup() в таблице тегов буфера для получения gtktexttag, затем вызывает gtk_text_buffer_apply_tag().

buffer :

gtktextbuffer

name :

имя gtktexttag

start :

один конец области

end :

другой конец области

gtk_text_buffer_remove_tag_by_name ()

void        gtk_text_buffer_remove_tag_by_name
                                            (gtktextbuffer *buffer,
                                             const gchar *name,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

вызывает gtk_text_tag_table_lookup() в таблице тегов буфера для получения gtktexttag, затем вызывает gtk_text_buffer_remove_tag().

buffer :

gtktextbuffer

name :

имя gtktexttag

start :

один конец области

end :

другой конец области

gtk_text_buffer_remove_all_tags ()

void        gtk_text_buffer_remove_all_tags (gtktextbuffer *buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end);

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

buffer :

gtktextbuffer

start :

одна граница диапазона

end :

другая граница диапазона

gtk_text_buffer_create_tag ()

gtktexttag* gtk_text_buffer_create_tag      (gtktextbuffer *buffer,
                                             const gchar *tag_name,
                                             const gchar *first_property_name,
                                             ...);

создаёт тег и добавляет его в таблицу тегов для buffer. эквивалент для вызова gtk_text_tag_new() и затем добавления тега в таблицу тегов буфера. возвращаемым тегом владеет таблица тегов буфера, поэтому счет будет равен одному.

если tag_name это null, тег без имени.

если tag_name не-null, тег названный tag_name не должен уже существовать в таблице тегов для этого буфера.

аргумент first_property_name и последующие параметры являются списком свойств для установки тега, как с помощью g_object_set().

buffer :

gtktextbuffer

tag_name :

имя нового тега, или null

first_property_name :

имя первого свойства для установки, или null

... :

null-законченный список свойств имен и значений

возвращает :

новый тег

gtk_text_buffer_get_iter_at_line_offset ()

void        gtk_text_buffer_get_iter_at_line_offset
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number,
                                             gint char_offset);

определяет итератор размещаемый в точке char_offset внутри данной строки. точка char_offset должна существовать, смещение с конца строки не допускаются. помните символы, не байты; utf-8 может закодировать один символ несколькими байтами.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

line_number :

строка начиная с 0

char_offset :

смещение символов с начала строки

gtk_text_buffer_get_iter_at_offset ()

void        gtk_text_buffer_get_iter_at_offset
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint char_offset);

инициализирует iter указывающий char_offset символ с начала буферного ввода. если char_offset равен -1 или больше количества символов в буфере, iter инициализируется как конечный итератор, итератор соответствующий последнему доступному символу в буфере.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

char_offset :

символьное смещение с начала буфера, начиная с 0, или -1

gtk_text_buffer_get_iter_at_line ()

void        gtk_text_buffer_get_iter_at_line
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number);

инициализирует iter для начала данной строки.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

line_number :

строка начиная с 0

gtk_text_buffer_get_iter_at_line_index ()

void        gtk_text_buffer_get_iter_at_line_index
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gint line_number,
                                             gint byte_index);

определяет итератор указывающий byte_index внутри данной строки. byte_index должен быть началом символа utf-8, и не должен быть концом строки. помните bytes, не символы; utf-8 может закодировать один символ несколькими байтами.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

line_number :

строка начиная с 0

byte_index :

количество байт с начала строки

gtk_text_buffer_get_iter_at_mark ()

void        gtk_text_buffer_get_iter_at_mark
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextmark *mark);

инициализирует iter текущемй позицией mark.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

mark :

gtktextmark в buffer

gtk_text_buffer_get_iter_at_child_anchor ()

void        gtk_text_buffer_get_iter_at_child_anchor
                                            (gtktextbuffer *buffer,
                                             gtktextiter *iter,
                                             gtktextchildanchor *anchor);

определяет размещение anchor внутри buffer.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

anchor :

дочерний якорь который находится в buffer

gtk_text_buffer_get_start_iter ()

void        gtk_text_buffer_get_start_iter  (gtktextbuffer *buffer,
                                             gtktextiter *iter);

инициализирует iter первой позицией в текстовом буфере. тоже самое как использовать gtk_text_buffer_get_iter_at_offset() для получения итератора символьного смещения равного 0.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

gtk_text_buffer_get_end_iter ()

void        gtk_text_buffer_get_end_iter    (gtktextbuffer *buffer,
                                             gtktextiter *iter);

инициализирует iter как "end iterator", последний доступный символ в текстовом буфере. если разыменован с помощью gtk_text_iter_get_char(), конечный итератор имеет значение 0. вся площадь буфера в диапазоне с первой позиции (вызывает gtk_text_buffer_get_start_iter() для получения символа в позиции 0) до конечного итератора.

buffer :

gtktextbuffer

iter :

инициализируемый итератор

gtk_text_buffer_get_bounds ()

void        gtk_text_buffer_get_bounds      (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);

определяет первый и последний итератор в буфере, то есть вся площадь буфера в диапазоне [start,end].

buffer :

gtktextbuffer

start :

инициализируемый итератор первой позицией буфера

end :

инициализируемый итератор конечным итератором

gtk_text_buffer_get_modified ()

gboolean    gtk_text_buffer_get_modified    (gtktextbuffer *buffer);

указывает был ли буфер изменён, с тех пор когда последний вызов gtk_text_buffer_set_modified() устанавливал флажок изменения в false. используется например для включения функции "save" в текстовых редакторах.

buffer :

gtktextbuffer

возвращает :

true если буфер был изменён

gtk_text_buffer_set_modified ()

void        gtk_text_buffer_set_modified    (gtktextbuffer *buffer,
                                             gboolean setting);

используется для слежения за изменениями буфера, с момента последнего сохранения. каждый раз при сохранении буфера на диск, вызывается gtk_text_buffer_set_modified (buffer, false). когда буфер изменяется, это будет автоматически переключено на модифицирующий бит снова. когда модифицирующий бит изменяется, буфер издаёт сигнал "modified_changed".

buffer :

gtktextbuffer

setting :

установки флажка изменений

gtk_text_buffer_delete_selection ()

gboolean    gtk_text_buffer_delete_selection
                                            (gtktextbuffer *buffer,
                                             gboolean interactive,
                                             gboolean default_editable);

удаляет диапазон между "insert" и "selection_bound" маркерами, который является текущим выделенным текстом. если interactive равно true, возможность редактирования будет принята во внимание (пользователь не может удалять не доступны для редактирования текст).

buffer :

gtktextbuffer

interactive :

вызвано ли удаление пользователем

default_editable :

доступен ли буфер для редактирования по умолчанию

возвращает :

не было ли пустым выделение для удаления

gtk_text_buffer_paste_clipboard ()

void        gtk_text_buffer_paste_clipboard (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard,
                                             gtktextiter *override_location,
                                             gboolean default_editable);

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

buffer :

gtktextbuffer

clipboard :

gtkclipboard из которого вставляются данные

override_location :

размещение вставляемого текста, или null для размещения на курсоре

default_editable :

редактируем ли буфер по умолчанию

gtk_text_buffer_copy_clipboard ()

void        gtk_text_buffer_copy_clipboard  (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);

копирует выделенный текст в буфер обмена.

buffer :

gtktextbuffer

clipboard :

gtkclipboard объект для копирования.

gtk_text_buffer_cut_clipboard ()

void        gtk_text_buffer_cut_clipboard   (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard,
                                             gboolean default_editable);

копирует текущеме выделение текста в буфер обмена, затем удаляет скажем текст, если он доступен для редактирования.

buffer :

gtktextbuffer

clipboard :

gtkclipboard объект для вырезания.

default_editable :

редактируемость буфера по умолчанию

gtk_text_buffer_get_selection_bounds ()

gboolean    gtk_text_buffer_get_selection_bounds
                                            (gtktextbuffer *buffer,
                                             gtktextiter *start,
                                             gtktextiter *end);

возвращает true если некоторый текст выделен; помещает границы выделения в start и end (если выделение имеет длину 0, то когда start и end заполняются одинаковым значением). start и end будут в порядке возрастания. если start и end равны null, то когда они не заполняются, но возвращаемое значение всё ещё указывает выделен ли текст.

buffer :

gtktextbuffer

start :

инициализируемый итератор началом выделения

end :

инициализируемый итератор концом выделения

возвращает :

имеет ли выделение не нулевую длину

gtk_text_buffer_begin_user_action ()

void        gtk_text_buffer_begin_user_action
                                            (gtktextbuffer *buffer);

вызывается для указания буферных операций между этой и вызовом gtk_text_buffer_end_user_action() являющихся частью одной видимой пользователем операции. операции между gtk_text_buffer_begin_user_action() и gtk_text_buffer_end_user_action() могут группироваться создавая стек отмены действий. gtktextbuffer поддерживает подсчет вызовов gtk_text_buffer_begin_user_action() которые не были закрыты вызовом gtk_text_buffer_end_user_action(), и издаёт сигналы "begin_user_action" и "end_user_action" только для парных крайних вызовов. это позволяет создавать действия пользователя из других действий пользователя.

функции интерактивных ("interactive") изменений буфера, такие как gtk_text_buffer_insert_interactive(), автоматически вызывают начало/конец действия пользователя около буферных операций которые они вызвали, поэтому нет необходимости в дополнительных вызовах, если ваше пользовательское действие состоит из вызова одной из этих функций.

buffer :

gtktextbuffer

gtk_text_buffer_end_user_action ()

void        gtk_text_buffer_end_user_action (gtktextbuffer *buffer);

должна быть парной с функцией gtk_text_buffer_begin_user_action().

buffer :

gtktextbuffer

gtk_text_buffer_add_selection_clipboard ()

void        gtk_text_buffer_add_selection_clipboard
                                            (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);

добавляет clipboard в список буферов обмена в которых выбор содержимого buffer является доступным. в большинстве случаев, clipboard будет gtkclipboard типа gdk_selection_primary для просмотра buffer.

buffer :

gtktextbuffer

clipboard :

gtkclipboard

gtk_text_buffer_remove_selection_clipboard ()

void        gtk_text_buffer_remove_selection_clipboard
                                            (gtktextbuffer *buffer,
                                             gtkclipboard *clipboard);

удаляет gtkclipboard добавленный с помощью gtk_text_buffer_add_selection_clipboard()

buffer :

gtktextbuffer

clipboard :

gtkclipboard добавляемый к buffer функцией gtk_text_buffer_add_selection_clipboard().

enum gtktextbuffertargetinfo

typedef enum
{
  gtk_text_buffer_target_info_buffer_contents = g_maxuint - 0,
  gtk_text_buffer_target_info_rich_text       = g_maxuint - 1,
  gtk_text_buffer_target_info_text            = g_maxuint - 2
} gtktextbuffertargetinfo;

gtktextbufferdeserializefunc ()

gboolean    (*gtktextbufferdeserializefunc) (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gtktextiter *iter,
                                             const guint8 *data,
                                             gsize length,
                                             gboolean create_tags,
                                             gpointer user_data,
                                             gerror **error);

register_buffer :

content_buffer :

iter :

data :

length :

create_tags :

user_data :

error :

возвращает :

gtk_text_buffer_deserialize ()

gboolean    gtk_text_buffer_deserialize     (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gdkatom format,
                                             gtktextiter *iter,
                                             const guint8 *data,
                                             gsize length,
                                             gerror **error);

эта функция преобразует rtf текст в формат format и вставляет его в iter.

formatы для использования должны быть зарегистрированы с помощью gtk_text_buffer_register_deserialize_format() или gtk_text_buffer_register_deserialize_tagset() заранее.

register_buffer :

gtktextbuffer format в котором зарегистрирован

content_buffer :

gtktextbuffer в который преобразуется

format :

rtf формат для преобразования

iter :

расположение для преобразованного текста

data :

данные для преобразования

length :

длина data

error :

возвращаемое расположение для gerror

возвращает :

true если выполнено, иначе false.

начиная с версии 2.10

gtk_text_buffer_deserialize_get_can_create_tags ()

gboolean    gtk_text_buffer_deserialize_get_can_create_tags
                                            (gtktextbuffer *buffer,
                                             gdkatom format);

эта функция возвращает значение установленное с помощью gtk_text_buffer_deserialize_set_can_create_tags()

buffer :

gtktextbuffer

format :

gdkatom зарегистрированного формата rtf

возвращает :

может ли преобразование этого формата создать теги

начиная с версии 2.10

gtk_text_buffer_deserialize_set_can_create_tags ()

void        gtk_text_buffer_deserialize_set_can_create_tags
                                            (gtktextbuffer *buffer,
                                             gdkatom format,
                                             gboolean can_create_tags);

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

способна создавать новые (произвольные!) теги в полученном буфере, имеется ввиду для специальных форматов rtf, как внутренние которые зарегистрированы с помощью gtk_text_buffer_register_deserialize_tagset(), потому что этот формат по существу дамп внутренней структуры исходного буфера, включая имена тегов.

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

buffer :

gtktextbuffer

format :

gdkatom представляющий регистрируемый rtf формат

can_create_tags :

может ли преобразование этого формата создавать теги

начиная с версии 2.10

gtk_text_buffer_get_copy_target_list ()

gtktargetlist* gtk_text_buffer_get_copy_target_list
                                            (gtktextbuffer *buffer);

эта функция возвращает список адресов, которые этот текстовый буфер может обеспечить для копирования и как источник dnd. адреса в списке добавляются со значением info из перечисления gtktextbuffertargetinfo enum, используя gtk_target_list_add_rich_text_targets() и gtk_target_list_add_text_targets()

buffer :

gtktextbuffer

возвращает :

gtktargetlist

начиная с версии 2.10

gtk_text_buffer_get_deserialize_formats ()

gdkatom*    gtk_text_buffer_get_deserialize_formats
                                            (gtktextbuffer *buffer,
                                             gint *n_formats);

эта функция возвращает rtf преобразованный формат зарегистрированный с buffer используя gtk_text_buffer_register_deserialize_format() или gtk_text_buffer_register_deserialize_tagset()

buffer :

gtktextbuffer

n_formats :

место хранения возвращаемого значения количества форматов

возвращает :

массив gdkatoms представляющий зарегистрированные форматы.

начиная с версии 2.10

gtk_text_buffer_get_paste_target_list ()

gtktargetlist* gtk_text_buffer_get_paste_target_list
                                            (gtktextbuffer *buffer);

эта функция возвращает список адресов поддерживаемых этим текстовым буфером для вставки и как место назначения dnd. адреса в списке добавляются со значением info из перечисления gtktextbuffertargetinfo, используя gtk_target_list_add_rich_text_targets() и gtk_target_list_add_text_targets()

buffer :

gtktextbuffer

возвращает :

gtktargetlist

начиная с версии 2.10

gtk_text_buffer_get_serialize_formats ()

gdkatom*    gtk_text_buffer_get_serialize_formats
                                            (gtktextbuffer *buffer,
                                             gint *n_formats);

эта функция возвращает rtf формат зарегистрированный с buffer используя gtk_text_buffer_register_serialize_format() или gtk_text_buffer_register_serialize_tagset()

buffer :

gtktextbuffer

n_formats :

место хранения возвращаемого значения количества форматов

возвращает :

массив gdkatoms представляющий зарегистрированные форматы.

начиная с версии 2.10

gtk_text_buffer_register_deserialize_format ()

gdkatom     gtk_text_buffer_register_deserialize_format
                                            (gtktextbuffer *buffer,
                                             const gchar *mime_type,
                                             gtktextbufferdeserializefunc function,
                                             gpointer user_data,
                                             gdestroynotify user_data_destroy);

эта функция регистрирует rtf текстовую function преобразования из последовательной формы в параллельную вместе с её mime_type с переданным buffer.

buffer :

gtktextbuffer

mime_type :

форматы mime-type

function :

функция преобразования для регистрации

user_data :

function's user_data

user_data_destroy :

функция вызываемая когда user_data больше не нужна

возвращает :

gdkatom который соответствует вновь зарегистрированному формату mime-type.

начиная с версии 2.10

gtk_text_buffer_register_deserialize_tagset ()

gdkatom     gtk_text_buffer_register_deserialize_tagset
                                            (gtktextbuffer *buffer,
                                             const gchar *tagset_name);

эта функция регистрирует внутри gtk+'s rtf преобразованный из последовательной формы в параллельную формат с переданным buffer. смотрите gtk_text_buffer_register_serialize_tagset().

buffer :

gtktextbuffer

tagset_name :

дополнительно имя установленного тега, или null

возвращает :

gdkatom который соответствует вновь зарегистрированному формату mime-type.

начиная с версии 2.10

gtk_text_buffer_register_serialize_format ()

gdkatom     gtk_text_buffer_register_serialize_format
                                            (gtktextbuffer *buffer,
                                             const gchar *mime_type,
                                             gtktextbufferserializefunc function,
                                             gpointer user_data,
                                             gdestroynotify user_data_destroy);

эта функция регистрирует rtf текстовую function преобразования в последовательную форму с её mime_type с переданным buffer.

buffer :

gtktextbuffer

mime_type :

форматы mime-type

function :

функция преобразования для регистрации

user_data :

function's user_data

user_data_destroy :

функция вызываемая когда user_data больше не нужна

возвращает :

gdkatom который соответствует вновь зарегистрированному формату mime-type.

начиная с версии 2.10

gtk_text_buffer_register_serialize_tagset ()

gdkatom     gtk_text_buffer_register_serialize_tagset
                                            (gtktextbuffer *buffer,
                                             const gchar *tagset_name);

эта функция регистрирует внутри gtk+'s rtf преобразованный в последовательную форму формат с переданным buffer. внутренний формат не подчиняется никакому стандарту rtf и работает только между образцов gtktextbuffer. это способствует преобразованию в последовательную форму всех тегов текстовых буферов и внедрённых изображений.

эта функция просто оболочка для gtk_text_buffer_register_serialize_format(). mime_type используемые для регистрации это "application/x-gtk-text-buffer-rich-text", или "application/x-gtk-text-buffer-rich-text;format=tagset_name" если tagset_name было помещено.

tagset_name может использоваться для ограничения передачи rtf в буферы с совмещенными наборами тегов, исключая неизвестные теги. это вероятно обычный способ передать идентификатор != null, так как null заставляет получающий буфер иметь дело со вставкой произвольных тегов.

buffer :

gtktextbuffer

tagset_name :

дополнительно имя устанавливаемого тега, или null

возвращает :

gdkatom который соответствует вновь зарегистрированному формату mime-type.

начиная с версии 2.10

gtktextbufferserializefunc ()

guint8*     (*gtktextbufferserializefunc)   (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gsize *length,
                                             gpointer user_data);

register_buffer :

content_buffer :

start :

end :

length :

user_data :

возвращает :

gtk_text_buffer_serialize ()

guint8*     gtk_text_buffer_serialize       (gtktextbuffer *register_buffer,
                                             gtktextbuffer *content_buffer,
                                             gdkatom format,
                                             const gtktextiter *start,
                                             const gtktextiter *end,
                                             gsize *length);

эта функция преобразует в последовательный формат часть текста находящийся между start и end в rtf представленном format.

formats для использования должны быть предварительно зарегистрированы с помощью gtk_text_buffer_register_serialize_format() или gtk_text_buffer_register_serialize_tagset().

register_buffer :

gtktextbuffer format который зарегистрирован

content_buffer :

gtktextbuffer для преобразования в последовательный формат

format :

rtf используемый для преобразования в последовательный формат

start :

начало блока текста для преобразования

end :

конец блока текста для преобразования

length :

место хранения возвращаемого значения длины преобразуемых в последовательный формат данных

возвращает :

преобразованные в последовательный формат данные, закодированные как format

начиная с версии 2.10

gtk_text_buffer_unregister_deserialize_format ()

void        gtk_text_buffer_unregister_deserialize_format
                                            (gtktextbuffer *buffer,
                                             gdkatom format);

снимает регистрацию rtf который был предварительно зарегистрирован с помощью gtk_text_buffer_register_deserialize_format() или gtk_text_buffer_register_deserialize_tagset()

buffer :

gtktextbuffer

format :

gdkatom соответствующий зарегистрированному rtf формату.

начиная с версии 2.10

gtk_text_buffer_unregister_serialize_format ()

void        gtk_text_buffer_unregister_serialize_format
                                            (gtktextbuffer *buffer,
                                             gdkatom format);

снимает регистрацию rtf который был предварительно зарегистрирован с помощью gtk_text_buffer_register_serialize_format() или gtk_text_buffer_register_serialize_tagset()

buffer :

gtktextbuffer

format :

gdkatom соответствующий зарегистрированному rtf формату.

начиная с версии 2.10

детали свойств

свойство "copy-target-list"

  "copy-target-list"     gtktargetlist         : read

список адресов поддерживаемых этим буфером для копирования через буфер обмена и как источник dnd.

начиная с версии 2.10

свойство "cursor-position"

  "cursor-position"      gint                  : read

позиция вставляемого маркера (как смещение из начала буфера). это полезно для получения уведомления о перемещении курсора.

допустимые значения: >= 0

значение по умолчанию: 0

начиная с версии 2.10

свойство "has-selection"

  "has-selection"        gboolean              : read

имеет ли буфер текущеме текстовое выделение.

значение по умолчанию: false

начиная с версии 2.10

свойство "paste-target-list"

  "paste-target-list"    gtktargetlist         : read

список целей поддерживаемых этим буфером для вставки через буфер обмена и как место назначения dnd.

начиная с версии 2.10

свойство "tag-table"

  "tag-table"            gtktexttagtable       : read / write / construct only

таблица текстовых тегов.

свойство "text"

  "text"                 gchararray            : read / write

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

значение по умолчанию: ""

начиная с версии 2.8

детали сигналов

сигнал "apply-tag"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktexttag    *arg1,
                                            gtktextiter   *arg2,
                                            gtktextiter   *arg3,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

arg3 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "begin-user-action"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "changed"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "delete-range"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gtktextiter   *arg2,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "end-user-action"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "insert-child-anchor"

void        user_function                  (gtktextbuffer      *textbuffer,
                                            gtktextiter        *arg1,
                                            gtktextchildanchor *arg2,
                                            gpointer            user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "insert-pixbuf"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gdkpixbuf     *arg2,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "insert-text"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gchar         *arg2,
                                            gint           arg3,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

arg3 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "mark-deleted"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktextmark   *arg1,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "mark-set"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktextiter   *arg1,
                                            gtktextmark   *arg2,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "modified-changed"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

сигнал "remove-tag"

void        user_function                  (gtktextbuffer *textbuffer,
                                            gtktexttag    *arg1,
                                            gtktextiter   *arg2,
                                            gtktextiter   *arg3,
                                            gpointer       user_data)       : run last

textbuffer :

объект получающий сигнал.

arg1 :

arg2 :

arg3 :

user_data :

пользовательские данные устанавливаемые при подключении обработчика сигнала.

смотрите также

gtktextview, gtktextiter, gtktextmark