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

#include <gtk/gtk.h>


            gtktextview;
enum        gtktextwindowtype;

gtkwidget*  gtk_text_view_new               (void);
gtkwidget*  gtk_text_view_new_with_buffer   (gtktextbuffer *buffer);
void        gtk_text_view_set_buffer        (gtktextview *text_view,
                                             gtktextbuffer *buffer);

gtktextbuffer* gtk_text_view_get_buffer     (gtktextview *text_view);
void        gtk_text_view_scroll_to_mark    (gtktextview *text_view,
                                             gtktextmark *mark,
                                             gdouble within_margin,
                                             gboolean use_align,
                                             gdouble xalign,
                                             gdouble yalign);

gboolean    gtk_text_view_scroll_to_iter    (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gdouble within_margin,
                                             gboolean use_align,
                                             gdouble xalign,
                                             gdouble yalign);
void        gtk_text_view_scroll_mark_onscreen

                                            (gtktextview *text_view,
                                             gtktextmark *mark);
gboolean    gtk_text_view_move_mark_onscreen
                                            (gtktextview *text_view,
                                             gtktextmark *mark);

gboolean    gtk_text_view_place_cursor_onscreen
                                            (gtktextview *text_view);
void        gtk_text_view_get_visible_rect  (gtktextview *text_view,
                                             gdkrectangle *visible_rect);
void        gtk_text_view_get_iter_location (gtktextview *text_view,
                                             const gtktextiter *iter,
                                             gdkrectangle *location);
void        gtk_text_view_get_line_at_y     (gtktextview *text_view,
                                             gtktextiter *target_iter,
                                             gint y,
                                             gint *line_top);
void        gtk_text_view_get_line_yrange   (gtktextview *text_view,
                                             const gtktextiter *iter,
                                             gint *y,
                                             gint *height);
void        gtk_text_view_get_iter_at_location

                                            (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint x,
                                             gint y);
void        gtk_text_view_get_iter_at_position
                                            (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint *trailing,
                                             gint x,
                                             gint y);
void        gtk_text_view_buffer_to_window_coords

                                            (gtktextview *text_view,
                                             gtktextwindowtype win,
                                             gint buffer_x,
                                             gint buffer_y,
                                             gint *window_x,
                                             gint *window_y);
void        gtk_text_view_window_to_buffer_coords

                                            (gtktextview *text_view,
                                             gtktextwindowtype win,
                                             gint window_x,
                                             gint window_y,
                                             gint *buffer_x,
                                             gint *buffer_y);

gdkwindow*  gtk_text_view_get_window        (gtktextview *text_view,
                                             gtktextwindowtype win);
gtktextwindowtype gtk_text_view_get_window_type
                                            (gtktextview *text_view,
                                             gdkwindow *window);
void        gtk_text_view_set_border_window_size

                                            (gtktextview *text_view,
                                             gtktextwindowtype type,
                                             gint size);
gint        gtk_text_view_get_border_window_size
                                            (gtktextview *text_view,
                                             gtktextwindowtype type);

gboolean    gtk_text_view_forward_display_line
                                            (gtktextview *text_view,
                                             gtktextiter *iter);
gboolean    gtk_text_view_backward_display_line
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

gboolean    gtk_text_view_forward_display_line_end
                                            (gtktextview *text_view,
                                             gtktextiter *iter);
gboolean    gtk_text_view_backward_display_line_start
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

gboolean    gtk_text_view_starts_display_line
                                            (gtktextview *text_view,
                                             const gtktextiter *iter);
gboolean    gtk_text_view_move_visually     (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint count);
void        gtk_text_view_add_child_at_anchor

                                            (gtktextview *text_view,
                                             gtkwidget *child,
                                             gtktextchildanchor *anchor);
            gtktextchildanchor;
gtktextchildanchor* gtk_text_child_anchor_new

                                            (void);
glist*      gtk_text_child_anchor_get_widgets
                                            (gtktextchildanchor *anchor);
gboolean    gtk_text_child_anchor_get_deleted
                                            (gtktextchildanchor *anchor);
void        gtk_text_view_add_child_in_window

                                            (gtktextview *text_view,
                                             gtkwidget *child,
                                             gtktextwindowtype which_window,
                                             gint xpos,
                                             gint ypos);
void        gtk_text_view_move_child        (gtktextview *text_view,
                                             gtkwidget *child,
                                             gint xpos,
                                             gint ypos);
void        gtk_text_view_set_wrap_mode     (gtktextview *text_view,
                                             gtkwrapmode wrap_mode);

gtkwrapmode gtk_text_view_get_wrap_mode     (gtktextview *text_view);
void        gtk_text_view_set_editable      (gtktextview *text_view,
                                             gboolean setting);

gboolean    gtk_text_view_get_editable      (gtktextview *text_view);
void        gtk_text_view_set_cursor_visible
                                            (gtktextview *text_view,
                                             gboolean setting);

gboolean    gtk_text_view_get_cursor_visible
                                            (gtktextview *text_view);
void        gtk_text_view_set_overwrite     (gtktextview *text_view,
                                             gboolean overwrite);

gboolean    gtk_text_view_get_overwrite     (gtktextview *text_view);
void        gtk_text_view_set_pixels_above_lines
                                            (gtktextview *text_view,
                                             gint pixels_above_lines);

gint        gtk_text_view_get_pixels_above_lines
                                            (gtktextview *text_view);
void        gtk_text_view_set_pixels_below_lines
                                            (gtktextview *text_view,
                                             gint pixels_below_lines);

gint        gtk_text_view_get_pixels_below_lines
                                            (gtktextview *text_view);
void        gtk_text_view_set_pixels_inside_wrap
                                            (gtktextview *text_view,
                                             gint pixels_inside_wrap);

gint        gtk_text_view_get_pixels_inside_wrap
                                            (gtktextview *text_view);
void        gtk_text_view_set_justification (gtktextview *text_view,
                                             gtkjustification justification);

gtkjustification gtk_text_view_get_justification
                                            (gtktextview *text_view);
void        gtk_text_view_set_left_margin   (gtktextview *text_view,
                                             gint left_margin);

gint        gtk_text_view_get_left_margin   (gtktextview *text_view);
void        gtk_text_view_set_right_margin  (gtktextview *text_view,
                                             gint right_margin);

gint        gtk_text_view_get_right_margin  (gtktextview *text_view);
void        gtk_text_view_set_indent        (gtktextview *text_view,
                                             gint indent);

gint        gtk_text_view_get_indent        (gtktextview *text_view);
void        gtk_text_view_set_tabs          (gtktextview *text_view,
                                             pangotabarray *tabs);

pangotabarray* gtk_text_view_get_tabs       (gtktextview *text_view);
void        gtk_text_view_set_accepts_tab   (gtktextview *text_view,
                                             gboolean accepts_tab);

gboolean    gtk_text_view_get_accepts_tab   (gtktextview *text_view);
gtktextattributes* gtk_text_view_get_default_attributes
                                            (gtktextview *text_view);
#define     gtk_text_view_priority_validate

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

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcontainer
                           +----gtktextview

  gobject
   +----gtktextchildanchor

осуществляемые интерфейсы

gtktextview осуществляет atkimplementoriface.

свойства

  "accepts-tab"          gboolean              : read / write
  "buffer"               gtktextbuffer         : read / write
  "cursor-visible"       gboolean              : read / write
  "editable"             gboolean              : read / write
  "indent"               gint                  : read / write
  "justification"        gtkjustification      : read / write
  "left-margin"          gint                  : read / write
  "overwrite"            gboolean              : read / write
  "pixels-above-lines"   gint                  : read / write
  "pixels-below-lines"   gint                  : read / write
  "pixels-inside-wrap"   gint                  : read / write
  "right-margin"         gint                  : read / write
  "tabs"                 pangotabarray         : read / write
  "wrap-mode"            gtkwrapmode           : read / write

свойства стиля

  "error-underline-color" gdkcolor              : read

сигналы

"backspace" void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action
"copy-clipboard"
            void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action
"cut-clipboard"
            void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action
"delete-from-cursor"
            void        user_function      (gtktextview   *textview,
                                            gtkdeletetype *arg1,
                                            gint           arg2,
                                            gpointer       user_data)      : run last / action
"insert-at-cursor"
            void        user_function      (gtktextview *textview,
                                            gchar       *arg1,
                                            gpointer     user_data)      : run last / action
"move-cursor"
            void        user_function      (gtktextview     *widget,
                                            gtkmovementstep *step,
                                            gint             count,
                                            gboolean         extend_selection,
                                            gpointer         user_data)             : run last / action
"move-focus"
            void        user_function      (gtktextview      *textview,
                                            gtkdirectiontype *arg1,
                                            gpointer          user_data)      : run last / action
"move-viewport"
            void        user_function      (gtktextview   *textview,
                                            gtkscrollstep *arg1,
                                            gint           arg2,
                                            gpointer       user_data)      : run last / action
"page-horizontally"
            void        user_function      (gtktextview *textview,
                                            gint         arg1,
                                            gboolean     arg2,
                                            gpointer     user_data)      : run last / action
"paste-clipboard"
            void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action
"populate-popup"
            void        user_function      (gtktextview *textview,
                                            gtkmenu     *arg1,
                                            gpointer     user_data)      : run last
"select-all"
            void        user_function      (gtktextview *textview,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action
"set-anchor"
            void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action
"set-scroll-adjustments"
            void        user_function      (gtktextview   *textview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action
"toggle-overwrite"
            void        user_function      (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

описание

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

детали

gtktextview

typedef struct _gtktextview gtktextview;

enum gtktextwindowtype

typedef enum
{
  gtk_text_window_private,
  gtk_text_window_widget,
  gtk_text_window_text,
  gtk_text_window_left,
  gtk_text_window_right,
  gtk_text_window_top,
  gtk_text_window_bottom
} gtktextwindowtype;

gtk_text_view_new ()

gtkwidget*  gtk_text_view_new               (void);

создаёт новый gtktextview. по умолчанию создаётся пустой буфер, если вы перед использованием виджета для просмотра текста не вызвали gtk_text_view_set_buffer(). функция gtk_text_view_get_buffer()получает буфер. если вы хотите определить свой буфер, обратитесь к gtk_text_view_new_with_buffer().

gtk_text_view_new_with_buffer ()

gtkwidget*  gtk_text_view_new_with_buffer   (gtktextbuffer *buffer);

создаёт новый gtktextview отображающий буфер buffer. один буфер может быть доступен для множества виджетов. buffer может быть null для создания буфера по умолчанию, в этом случае эта функция эквивалентна gtk_text_view_new(). виджет просмотра текста добавляет свой собственный подсчет ссылок для буфера; он не принимает существующие ссылки.

gtk_text_view_set_buffer ()

void        gtk_text_view_set_buffer        (gtktextview *text_view,
                                             gtktextbuffer *buffer);

устанавливает буфер buffer как отображаемый в text_view. ссылка на предварительно отображённый буфер в виджете просмотра текста отменяется, а ссылка на buffer добавляется. если вы владели ссылкой для buffer перед добавлением его в эту функцию, вы должны удалить ссылку самостоятельно; gtktextview не "примет" её.

gtk_text_view_get_buffer ()

gtktextbuffer* gtk_text_view_get_buffer     (gtktextview *text_view);

возвращает gtktextbuffer отображаемый в text_view. подсчет ссылок в буфере не увеличивается; вызывающий эту функцию не владеет новой ссылкой.

gtk_text_view_scroll_to_mark ()

void        gtk_text_view_scroll_to_mark    (gtktextview *text_view,
                                             gtktextmark *mark,
                                             gdouble within_margin,
                                             gboolean use_align,
                                             gdouble xalign,
                                             gdouble yalign);

прокручивает text_view чтобы mark оказалась на экране в позиции указанной xalign и yalign. выравнивание 0.0 указывает левый или верхний, 1.0 указывает правый или нижний, 0.5 означает центр. если use_align это false, текст прокручивается на минимальное расстояние для получения маркера на экране, возможно не прокручивается вовсе. эффективный экран для целей этой функции, уменьшен до границ размера within_margin.

gtk_text_view_scroll_to_iter ()

gboolean    gtk_text_view_scroll_to_iter    (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gdouble within_margin,
                                             gboolean use_align,
                                             gdouble xalign,
                                             gdouble yalign);

прокручивает text_view чтобы iter находился в позиции экрана указанной xalign и yalign. выравнивание 0.0 указывает левый или верхний, 1.0 указывает правый или нижний, 0.5 означает центр. если use_align это false, текст прокручивается на минимальное расстояние для получения маркера на экране, возможно не прокручивается вовсе. эффективный экран для целей этой функции, уменьшен до границ размера within_margin. примечание: эта функция использует текущий расчет высоты строк в текстовом буфере. помните что высота строк расчитывается в неактивном обработчике; поэтому эта функция может не иметь желательного эффекта, если она вызвана перед расчетом высоты. для избежания нечетности, желательно использовать gtk_text_view_scroll_to_mark() которая сохраняет точку для прокручивания после подтверждения правильности строки.

gtk_text_view_scroll_mark_onscreen ()

void        gtk_text_view_scroll_mark_onscreen
                                            (gtktextview *text_view,
                                             gtktextmark *mark);

прокручивает text_view на минимальное расстояние так, чтобы mark находился в видимой области виджета.

gtk_text_view_move_mark_onscreen ()

gboolean    gtk_text_view_move_mark_onscreen
                                            (gtktextview *text_view,
                                             gtktextmark *mark);

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

gtk_text_view_place_cursor_onscreen ()

gboolean    gtk_text_view_place_cursor_onscreen
                                            (gtktextview *text_view);

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

gtk_text_view_get_visible_rect ()

void        gtk_text_view_get_visible_rect  (gtktextview *text_view,
                                             gdkrectangle *visible_rect);

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

gtk_text_view_get_iter_location ()

void        gtk_text_view_get_iter_location (gtktextview *text_view,
                                             const gtktextiter *iter,
                                             gdkrectangle *location);

получает прямоугольник который приблизительно содержит символ iter. прямоугольник позиционируется в буферных координатах; используйте gtk_text_view_buffer_to_window_coords() для конвертации этих координат в координаты одного из окон виджета для просмотра текста.

gtk_text_view_get_line_at_y ()

void        gtk_text_view_get_line_at_y     (gtktextview *text_view,
                                             gtktextiter *target_iter,
                                             gint y,
                                             gint *line_top);

выдаёт gtktextiter в начале строки содержащей координату y. y это в буферных координатах, конвертируется из координат окна с помощью gtk_text_view_window_to_buffer_coords(). если не-null, line_top будет заполнен координатами верхнего края строки.

gtk_text_view_get_line_yrange ()

void        gtk_text_view_get_line_yrange   (gtktextview *text_view,
                                             const gtktextiter *iter,
                                             gint *y,
                                             gint *height);

выдаёт y координату верхней строки содержащей iter, и высоту строки. координаты находятся в буферных координатах; конвертируются в координаты окна с помощью gtk_text_view_buffer_to_window_coords().

gtk_text_view_get_iter_at_location ()

void        gtk_text_view_get_iter_at_location
                                            (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint x,
                                             gint y);

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

gtk_text_view_get_iter_at_position ()

void        gtk_text_view_get_iter_at_position
                                            (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint *trailing,
                                             gint x,
                                             gint y);

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

помните что это отличается от gtk_text_view_get_iter_at_location(), которая возвращает размещение курсора, то есть позицию между символами.

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

gtk_text_view_buffer_to_window_coords ()

void        gtk_text_view_buffer_to_window_coords
                                            (gtktextview *text_view,
                                             gtktextwindowtype win,
                                             gint buffer_x,
                                             gint buffer_y,
                                             gint *window_x,
                                             gint *window_y);

преобразует координаты (buffer_x, buffer_y) в координаты для окна win, и сохраняет результат в (window_x, window_y).

помните что вы можете конвертировать координаты для несуществующего окна (смотрите gtk_text_view_set_border_window_size()).

gtk_text_view_window_to_buffer_coords ()

void        gtk_text_view_window_to_buffer_coords
                                            (gtktextview *text_view,
                                             gtktextwindowtype win,
                                             gint window_x,
                                             gint window_y,
                                             gint *buffer_x,
                                             gint *buffer_y);

преобразует координаты окна идентифицируемого как win в буферные координаты, сохраняя результат в (buffer_x,buffer_y).

помните что вы можете конвертировать координаты для несуществующего окна (смотрите gtk_text_view_set_border_window_size()).

gtk_text_view_get_window ()

gdkwindow*  gtk_text_view_get_window        (gtktextview *text_view,
                                             gtktextwindowtype win);

получает gdkwindow соответствующий области просмотра текста; возможное окно включает полный виджет окна, дочерние окна с лева, с право, сверху, снизу и окно которое отображает текстовый буфер. окна равны null и не существуют если их ширина и высота равна 0, а также не существуют перед реализацией виджета.

gtk_text_view_get_window_type ()

gtktextwindowtype gtk_text_view_get_window_type
                                            (gtktextview *text_view,
                                             gdkwindow *window);

удобна для поиска окна соответствующего событию. если вы подключаете для события сигнал в text_view, эта функция должна быть вызвана в event->window чтобы видеть каким окном оно было.

gtk_text_view_set_border_window_size ()

void        gtk_text_view_set_border_window_size
                                            (gtktextview *text_view,
                                             gtktextwindowtype type,
                                             gint size);

устанавливает ширину gtk_text_window_left или gtk_text_window_right, или высоту gtk_text_window_top или gtk_text_window_bottom. автоматически разрушает соответствующее окно если размер установлен в 0, и создаёт окно если размер не ноль. эта функция может использоваться только для "border windows", она не работает с gtk_text_window_widget, gtk_text_window_text, или gtk_text_window_private.

gtk_text_view_get_border_window_size ()

gint        gtk_text_view_get_border_window_size
                                            (gtktextview *text_view,
                                             gtktextwindowtype type);

определяет ширину границ окна. смотрите gtk_text_view_set_border_window_size().

gtk_text_view_forward_display_line ()

gboolean    gtk_text_view_forward_display_line
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

перемещает данный iter вперед на одну отображаемую строку (обёрнутую). отображаемая строка отличается от параграфа. параграфы разделяются символами новой строки или другими символами разделения параграфов. отображаемая строка создаётся обертыванием строк параграфа. если обёртывание выключено, отображаемая строка и параграф одно и тоже. отображаемые строки разделяются для каждого вида по разному, так как это зависит от ширины вида; параграфы одинаковы во всех видах, так как они зависят от содержимого gtktextbuffer.

gtk_text_view_backward_display_line ()

gboolean    gtk_text_view_backward_display_line
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

перемещает данный iter назад на одну отображаемую строку (обёрнутую). отображаемая строка отличается от параграфа. параграфы разделяются символами новой строки или другими символами разделения параграфов. отображаемая строка создаётся обертыванием строк параграфа. если обёртывание выключено, отображаемая строка и параграф одно и тоже. отображаемые строки разделяются для каждого вида по разному, так как это зависит от ширины вида; параграфы одинаковы во всех видах, так как они зависят от содержимого gtktextbuffer.

gtk_text_view_forward_display_line_end ()

gboolean    gtk_text_view_forward_display_line_end
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

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

gtk_text_view_backward_display_line_start ()

gboolean    gtk_text_view_backward_display_line_start
                                            (gtktextview *text_view,
                                             gtktextiter *iter);

перемещает данный iter назад в начало следующей отображаемой строки. отображаемая строка отличается от параграфа. параграфы разделяются символами новой строки или другими символами разделения параграфов. отображаемая строка создаётся обертыванием строк параграфа. если обёртывание выключено, отображаемая строка и параграф одно и тоже. отображаемые строки разделяются для каждого вида по разному, так как это зависит от ширины вида; параграфы одинаковы во всех видах, так как они зависят от содержимого gtktextbuffer.

gtk_text_view_starts_display_line ()

gboolean    gtk_text_view_starts_display_line
                                            (gtktextview *text_view,
                                             const gtktextiter *iter);

определяет является ли iter началом отображаемой строки. смотрите gtk_text_view_forward_display_line() для разъяснений отличий между отображаемой строкой и параграфом.

gtk_text_view_move_visually ()

gboolean    gtk_text_view_move_visually     (gtktextview *text_view,
                                             gtktextiter *iter,
                                             gint count);

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

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

gtk_text_view_add_child_at_anchor ()

void        gtk_text_view_add_child_at_anchor
                                            (gtktextview *text_view,
                                             gtkwidget *child,
                                             gtktextchildanchor *anchor);

добавляет дочерний виджет в текстовый буфер, в данный anchor.

gtktextchildanchor

typedef struct _gtktextchildanchor gtktextchildanchor;

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

gtk_text_child_anchor_new ()

gtktextchildanchor* gtk_text_child_anchor_new
                                            (void);

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

gtk_text_child_anchor_get_widgets ()

glist*      gtk_text_child_anchor_get_widgets
                                            (gtktextchildanchor *anchor);

определяет список всех виджетов закреплённых этим дочерним якорем. возвращаемый список должен освобождаться с помощью g_list_free().

gtk_text_child_anchor_get_deleted ()

gboolean    gtk_text_child_anchor_get_deleted
                                            (gtktextchildanchor *anchor);

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

gtk_text_view_add_child_in_window ()

void        gtk_text_view_add_child_in_window
                                            (gtktextview *text_view,
                                             gtkwidget *child,
                                             gtktextwindowtype which_window,
                                             gint xpos,
                                             gint ypos);

добавляет дочерний виджет в фиксированные координаты одного из окон текстового виджета. окно должно иметь не нулевой размер (смотрите gtk_text_view_set_border_window_size()). помните что дочерние координаты даются относительно рассматриваемого gdkwindow, и что эти координаты не имеют нормального отношения к прокрутке. размещая дочерний виджет в gtk_text_window_widget, прокручивание не уместно, дочерний виджет находится поверх всей прокручиваемой области. но помещая дочерний виджет в одно из прокручиваемых окон (border windows или text window), вам нужно расчитать корректную позицию дочернего виджета в буферных координатах каждый раз при прокручивании или изменении буфера, а затем вызвать gtk_text_view_move_child() для обновления позиции дочернего виджета. к сожалению сейчас нет хорошего способа обнаружения происходящей прокрутки, используя текущий api; возможный хак (hack), обновление всех позиций дочерних виджетов при прокручивании или изменении текстового буфера. смотрите ошибку 64518 в bugzilla.gnome.org для контроля состояния устранения этой проблемы.

gtk_text_view_move_child ()

void        gtk_text_view_move_child        (gtktextview *text_view,
                                             gtkwidget *child,
                                             gint xpos,
                                             gint ypos);

обновляет позицию дочернего виджета, как для gtk_text_view_add_child_in_window().

gtk_text_view_set_wrap_mode ()

void        gtk_text_view_set_wrap_mode     (gtktextview *text_view,
                                             gtkwrapmode wrap_mode);

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

gtk_text_view_get_wrap_mode ()

gtkwrapmode gtk_text_view_get_wrap_mode     (gtktextview *text_view);

определяет обёрнутые строки для просмотра.

gtk_text_view_set_editable ()

void        gtk_text_view_set_editable      (gtktextview *text_view,
                                             gboolean setting);

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

gtk_text_view_get_editable ()

gboolean    gtk_text_view_get_editable      (gtktextview *text_view);

возвращает значение по умолчанию возможности редактирования gtktextview. теги в буфере могут переписать эти установки для некоторого текстового диапазона.

gtk_text_view_set_cursor_visible ()

void        gtk_text_view_set_cursor_visible
                                            (gtktextview *text_view,
                                             gboolean setting);

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

gtk_text_view_get_cursor_visible ()

gboolean    gtk_text_view_get_cursor_visible
                                            (gtktextview *text_view);

определяет отображается ли курсор.

gtk_text_view_set_overwrite ()

void        gtk_text_view_set_overwrite     (gtktextview *text_view,
                                             gboolean overwrite);

изменяет режим перезаписи gtktextview.

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

gtk_text_view_get_overwrite ()

gboolean    gtk_text_view_get_overwrite     (gtktextview *text_view);

определяет включён ли режим перезаписи gtktextview.

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

gtk_text_view_set_pixels_above_lines ()

void        gtk_text_view_set_pixels_above_lines
                                            (gtktextview *text_view,
                                             gint pixels_above_lines);

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

gtk_text_view_get_pixels_above_lines ()

gint        gtk_text_view_get_pixels_above_lines
                                            (gtktextview *text_view);

определяет значение по умолчанию количества помещаемых пикселей выше параграфа.

gtk_text_view_set_pixels_below_lines ()

void        gtk_text_view_set_pixels_below_lines
                                            (gtktextview *text_view,
                                             gint pixels_below_lines);

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

gtk_text_view_get_pixels_below_lines ()

gint        gtk_text_view_get_pixels_below_lines
                                            (gtktextview *text_view);

определяет значение установленное с помощью gtk_text_view_set_pixels_below_lines().

gtk_text_view_set_pixels_inside_wrap ()

void        gtk_text_view_set_pixels_inside_wrap
                                            (gtktextview *text_view,
                                             gint pixels_inside_wrap);

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

gtk_text_view_get_pixels_inside_wrap ()

gint        gtk_text_view_get_pixels_inside_wrap
                                            (gtktextview *text_view);

определяет значение установленное с помощью gtk_text_view_set_pixels_inside_wrap().

gtk_text_view_set_justification ()

void        gtk_text_view_set_justification (gtktextview *text_view,
                                             gtkjustification justification);

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

gtk_text_view_get_justification ()

gtkjustification gtk_text_view_get_justification
                                            (gtktextview *text_view);

определяет выравнивание по умолчанию, параграфа в text_view. теги могут переписывать значения по умолчанию.

gtk_text_view_set_left_margin ()

void        gtk_text_view_set_left_margin   (gtktextview *text_view,
                                             gint left_margin);

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

gtk_text_view_get_left_margin ()

gint        gtk_text_view_get_left_margin   (gtktextview *text_view);

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

gtk_text_view_set_right_margin ()

void        gtk_text_view_set_right_margin  (gtktextview *text_view,
                                             gint right_margin);

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

gtk_text_view_get_right_margin ()

gint        gtk_text_view_get_right_margin  (gtktextview *text_view);

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

gtk_text_view_set_indent ()

void        gtk_text_view_set_indent        (gtktextview *text_view,
                                             gint indent);

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

gtk_text_view_get_indent ()

gint        gtk_text_view_get_indent        (gtktextview *text_view);

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

gtk_text_view_set_tabs ()

void        gtk_text_view_set_tabs          (gtktextview *text_view,
                                             pangotabarray *tabs);

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

gtk_text_view_get_tabs ()

pangotabarray* gtk_text_view_get_tabs       (gtktextview *text_view);

находит табуляторы по умолчанию для text_view. теги могут переписывать значения по умолчанию. возвращаемый массив будет null если используются табуляторы "standard" (8-space). освобождается возвращаемое значение с помощью pango_tab_array_free().

gtk_text_view_set_accepts_tab ()

void        gtk_text_view_set_accepts_tab   (gtktextview *text_view,
                                             gboolean accepts_tab);

устанавливает поведение текстового виджета при нажатии клавиши tab. если accepts_tab равно true вставляется табулятор. если accepts_tab равно false клавиатурный фокус перемещается на следующий виджет в цепочке фокусирования.

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

gtk_text_view_get_accepts_tab ()

gboolean    gtk_text_view_get_accepts_tab   (gtktextview *text_view);

определяет что происходит при нажатии на клавишу tab. смотрите gtk_text_view_set_accepts_tab().

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

gtk_text_view_get_default_attributes ()

gtktextattributes* gtk_text_view_get_default_attributes
                                            (gtktextview *text_view);

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

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

gtk_text_view_priority_validate

#define gtk_text_view_priority_validate (gdk_priority_redraw + 5)

приоритет в котором виджет текстового просмотра утверждает строки отображаемые на экране в фоне.

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

свойство "accepts-tab"

  "accepts-tab"          gboolean              : read / write

должен ли при нажатии клавиши tab вставляться табулятор.

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

свойство "buffer"

  "buffer"               gtktextbuffer         : read / write

отображаемый буфер.

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

  "cursor-visible"       gboolean              : read / write

если курсор отображается.

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

свойство "editable"

  "editable"             gboolean              : read / write

может ли текст модифицироваться пользователем.

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

свойство "indent"

  "indent"               gint                  : read / write

размер отступа параграфа, в пикселах.

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

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

свойство "justification"

  "justification"        gtkjustification      : read / write

левое, правое, или выравнивание по центру.

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

свойство "left-margin"

  "left-margin"          gint                  : read / write

ширина левого отступа в пикселах.

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

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

свойство "overwrite"

  "overwrite"            gboolean              : read / write

может ли перезаписываться существующее содержимое.

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

свойство "pixels-above-lines"

  "pixels-above-lines"   gint                  : read / write

интервал в пикселах вверху параграфов.

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

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

свойство "pixels-below-lines"

  "pixels-below-lines"   gint                  : read / write

интервал в пикселах внизу параграфов.

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

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

свойство "pixels-inside-wrap"

  "pixels-inside-wrap"   gint                  : read / write

интервал в пикселах между обёрнутыми строками.

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

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

свойство "right-margin"

  "right-margin"         gint                  : read / write

ширина правого отступа в пикселах.

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

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

свойство "tabs"

  "tabs"                 pangotabarray         : read / write

табуляторы для данного текста.

свойство "wrap-mode"

  "wrap-mode"            gtkwrapmode           : read / write

режим обёртывания строк – в границах слова, в границах символа или без обёртывания.

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

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

свойство стиля "error-underline-color"

  "error-underline-color" gdkcolor              : read

цвет подчеркивания сообщающего об ошибке.

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

сигнал "backspace"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

сигнал "copy-clipboard"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

сигнал "cut-clipboard"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

сигнал "delete-from-cursor"

void        user_function                  (gtktextview   *textview,
                                            gtkdeletetype *arg1,
                                            gint           arg2,
                                            gpointer       user_data)      : run last / action

сигнал "insert-at-cursor"

void        user_function                  (gtktextview *textview,
                                            gchar       *arg1,
                                            gpointer     user_data)      : run last / action

сигнал "move-cursor"

void        user_function                  (gtktextview     *widget,
                                            gtkmovementstep *step,
                                            gint             count,
                                            gboolean         extend_selection,
                                            gpointer         user_data)             : run last / action

сигнал ::move-cursor это сигнал привязки клавиш который издаётся когда пользователь перемещает курсор.

приложения не должны подключать его, но могут издавать его с помощью g_signal_emit_by_name() если нужно контролировать прокручивание программно.

сигнал "move-focus"

void        user_function                  (gtktextview      *textview,
                                            gtkdirectiontype *arg1,
                                            gpointer          user_data)      : run last / action

сигнал "move-viewport"

void        user_function                  (gtktextview   *textview,
                                            gtkscrollstep *arg1,
                                            gint           arg2,
                                            gpointer       user_data)      : run last / action

сигнал "page-horizontally"

void        user_function                  (gtktextview *textview,
                                            gint         arg1,
                                            gboolean     arg2,
                                            gpointer     user_data)      : run last / action

сигнал "paste-clipboard"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

сигнал "populate-popup"

void        user_function                  (gtktextview *textview,
                                            gtkmenu     *arg1,
                                            gpointer     user_data)      : run last

сигнал "select-all"

void        user_function                  (gtktextview *textview,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action

сигнал "set-anchor"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

сигнал "set-scroll-adjustments"

void        user_function                  (gtktextview   *textview,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last / action

сигнал "toggle-overwrite"

void        user_function                  (gtktextview *textview,
                                            gpointer     user_data)      : run last / action

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

gtktextbuffer, gtktextiter