GtkTextView

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

gtk_text_view_get_hadjustment ()

GtkAdjustment *
gtk_text_view_get_hadjustment (GtkTextView *text_view);

Возвращает горизонтальную настройка прокрутки GtkAdjustment.

Since: 2.22

gtk_text_view_get_vadjustment ()

GtkAdjustment *
gtk_text_view_get_vadjustment (GtkTextView *text_view);

Возвращает вертикальную настройка прокрутки GtkAdjustment.

Since: 2.22

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_cursor_locations ()

void
gtk_text_view_get_cursor_locations (GtkTextView *text_view,
                                    const GtkTextIter *iter,
                                    GdkRectangle *strong,
                                    GdkRectangle *weak);

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

Если iter равно NULL, используется фактическое положение курсора.

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

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

Since: 3.0

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 ()

gboolean
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 ()

gboolean
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, и создает окно, если размер установлен в ненулевое значение. Эту функцию можно использовать только для «окон границы», и она не будет работать с 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.

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()). Обратите внимание, что координаты дочернего элемента заданы относительно прокрутки. При размещении дочернего элемента в GTK_TEXT_WINDOW_WIDGET, прокрутка не имеет значения, дочерний элемент располагается над всеми областями прокрутки. Но при размещении дочернего элемента в одном из окон прокрутки (окна границы или окно текста) он будет перемещаться вместе с прокруткой по мере необходимости.

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-keynave-use-caret”.

gtk_text_view_get_cursor_visible ()

gboolean
gtk_text_view_get_cursor_visible (GtkTextView *text_view);

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

gtk_text_view_reset_cursor_blink ()

void
gtk_text_view_reset_cursor_blink (GtkTextView *text_view);

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

Эта функция должна вызываться в ответ на пользовательский ввод (например, от производных классов, которые переопределяют обработчик “key-press-event” виджета текстовой области).

Since: 3.20

gtk_text_view_set_overwrite ()

void
gtk_text_view_set_overwrite (GtkTextView *text_view,
                             gboolean overwrite);

Изменяет режим переписывания для GtkTextView.

Since: 2.4

gtk_text_view_get_overwrite ()

gboolean
gtk_text_view_get_overwrite (GtkTextView *text_view);

Возвращает, находится ли GtkTextView в режиме переписывания или нет.

Since: 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_get_pixels_below_lines() равно пробелу между строками каждого абзаца.

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_get_pixels_above_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. Теги в буфере могут переопределить стандартное значение.

Обратите внимание, что эта функция имеет запутанное имя. В терминах CSS заданное здесь значение — отступ.

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);

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

Обратите внимание, что эта функция имеет запутанное имя. В терминах CSS заданное здесь значение — отступ.

gtk_text_view_get_right_margin ()

gint
gtk_text_view_get_right_margin (GtkTextView *text_view);

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

gtk_text_view_set_top_margin ()

void
gtk_text_view_set_top_margin (GtkTextView *text_view,
                              gint top_margin);

Устанавливает верхний отступ для текста в text_view.

Обратите внимание, что эта функция имеет запутанное имя. В терминах CSS заданное здесь значение — отступ.

С: 3.18

gtk_text_view_get_top_margin ()

gint
gtk_text_view_get_top_margin (GtkTextView *text_view);

Получает верхний отступ текста в text_view.

С: 3.18

gtk_text_view_set_bottom_margin ()

void
gtk_text_view_set_bottom_margin (GtkTextView *text_view,
                                 gint bottom_margin);

Устанавливает нижнюю границу для текста в text_view.

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

Since: 3.18

gtk_text_view_get_bottom_margin ()

gint
gtk_text_view_get_bottom_margin (GtkTextView *text_view);

Получает нижнюю границу для текста в text_view.

Since: 3.18

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 если используются стандартные (8-пробельные) табуляции. Освободите возвращаемое значение с помощью 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, фокус клавиатуры переносится на следующий виджет в цепочке фокуса.

Since: 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().

Since: 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_attributes_unref().

gtk_text_view_im_context_filter_keypress ()

gboolean
gtk_text_view_im_context_filter_keypress
                               (GtkTextView *text_view,
                                GdkEventKey *event);

Разрешает методу ввода GtkTextView внутренне обрабатывать события нажатия и отпускания клавиш. Если эта функция возвращает TRUE, дальнейшая обработка этого события нажатия клавиши не должна выполняться. См. gtk_im_context_filter_keypress().

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

textview.view
├── border.top
├── border.left
├── text
│   ╰── [selection]
├── border.right
├── border.bottom
╰── [window.popup]

Since: 2.22

gtk_text_view_reset_im_context ()

void
gtk_text_view_reset_im_context (GtkTextView *text_view);

Сбросить контекст метода ввода текста, если это необходимо.

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

Since: 2.22

gtk_text_view_set_input_purpose ()

void
gtk_text_view_set_input_purpose (GtkTextView *text_view,
                                 GtkInputPurpose purpose);

Устанавливает свойство “input-purpose”, которое может использоваться экранными клавиатурами и другими методами ввода для изменения их поведения.

С: 3.6

gtk_text_view_get_input_purpose ()

GtkInputPurpose
gtk_text_view_get_input_purpose (GtkTextView *text_view);

Получает значение свойства “input-purpose”.

С: 3.6

gtk_text_view_set_input_hints ()

void
gtk_text_view_set_input_hints (GtkTextView *text_view,
                               GtkInputHints hints);

Устанавливает свойство “input-hints”, что позволяет методам ввода уточнять своё поведение.

С: 3.6

gtk_text_view_get_input_hints ()

GtkInputHints
gtk_text_view_get_input_hints (GtkTextView *text_view);

Получает значение свойства “input-hints”.

С: 3.6

gtk_text_view_set_monospace ()

void
gtk_text_view_set_monospace (GtkTextView *text_view,
                             gboolean monospace);

Устанавливает свойство “monospace”, которое указывает, что виджет должен использовать шрифты моноширины.

С: 3.16

gtk_text_view_get_monospace ()

gboolean
gtk_text_view_get_monospace (GtkTextView *text_view);

Получает значение свойства “monospace”.

Возвращает: TRUE если требуется шрифт моноширины

С: 3.16

struct GtkTextView

struct GtkTextView;

struct GtkTextViewClass

struct GtkTextViewClass {
  GtkContainerClass parent_class;

  void (* populate_popup)        (GtkTextView      *text_view,
                                  GtkWidget        *popup);
  void (* move_cursor)           (GtkTextView      *text_view,
                                  GtkMovementStep   step,
                                  gint              count,
                                  gboolean          extend_selection);
  void (* set_anchor)            (GtkTextView      *text_view);
  void (* insert_at_cursor)      (GtkTextView      *text_view,
                                  const gchar      *str);
  void (* delete_from_cursor)    (GtkTextView      *text_view,
                                  GtkDeleteType     type,
                                  gint              count);
  void (* backspace)             (GtkTextView      *text_view);
  void (* cut_clipboard)         (GtkTextView      *text_view);
  void (* copy_clipboard)        (GtkTextView      *text_view);
  void (* paste_clipboard)       (GtkTextView      *text_view);
  void (* toggle_overwrite)      (GtkTextView      *text_view);
  GtkTextBuffer * (* create_buffer) (GtkTextView   *text_view);
  void (* draw_layer)            (GtkTextView      *text_view,
			          GtkTextViewLayer  layer,
			          cairo_t          *cr);
  gboolean (* extend_selection)  (GtkTextView            *text_view,
                                  GtkTextExtendSelection  granularity,
                                  const GtkTextIter      *location,
                                  GtkTextIter            *start,
                                  GtkTextIter            *end);
  void (* insert_emoji)          (GtkTextView      *text_view);
};

enum GtkTextViewLayer

Используется для ссылки на слои GtkTextView в целях кастомизированной отрисовки с помощью метода ::draw_layer.

enum GtkTextWindowType

Используется для ссылки на части GtkTextView.

enum GtkTextExtendSelection

Типы гранулярности, которые расширяют текстовый выбор. Используйте сигнал “extend-selection” для настройки выбора.

С: 3.16

Перечисление GtkWrapMode

Описание типа обрезки строк.

Структура GtkTextChildAnchor

struct GtkTextChildAnchor;

GtkTextChildAnchor — это точка в буфере, где могут быть «привязаны» дочерние виджеты (вставлены в строку, как если бы они были символами). К якорю можно привязать несколько виджетов, чтобы обеспечить несколько представлений.

GTK_TEXT_VIEW_PRIORITY_VALIDATE

#define GTK_TEXT_VIEW_PRIORITY_VALIDATE (GDK_PRIORITY_REDRAW + 5)

Приоритет, с которым виджет текста валидирует строки на экране в фоновой задаче в режиме ожидания.

Сигнал “backspace”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::backspace — это сигнал для привязки клавиш, который генерируется при запросе пользователя.

По умолчанию для этого сигнала назначены клавиши Backspace и Shift-Backspace.

Флаги: Действие

Сигнал “copy-clipboard”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::copy-clipboard — это сигнал для привязки клавиш, который генерируется для копирования выделенного текста в буфер обмена.

По умолчанию для этого сигнала назначены клавиши Ctrl-c и Ctrl-Insert.

Флаги: Действие

Сигнал “cut-clipboard”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::cut-clipboard — это сигнал для привязки клавиш, который генерируется для вырезания выделенного текста в буфер обмена.

По умолчанию для этого сигнала назначены клавиши Ctrl-x и Shift-Delete.

Флаги: Действие

Сигнал “delete-from-cursor”

void
user_function (GtkTextView  *text_view,
               GtkDeleteType type,
               int           count,
               gpointer      user_data)

Сигнал ::delete-from-cursor — это сигнал для привязки клавиш, который генерируется при удалении текста пользователем.

Если type равен GTK_DELETE_CHARS, GTK+ удаляет выделение, если оно есть, иначе удаляет указанное количество символов.

По умолчанию для этого сигнала назначены клавиши Delete (удаление символа), Ctrl-Delete (удаление слова) и Ctrl-Backspace (удаление слова назад).

Флаги: Действие

Сигнал “extend-selection”

gboolean
user_function (GtkTextView           *text_view,
               GtkTextExtendSelection granularity,
               GtkTextIter           *location,
               GtkTextIter           *start,
               GtkTextIter           *end,
               gpointer               user_data)

Сигнал ::extend-selection генерируется, когда выделение нужно расширить в location.

Флаги: Выполнить последним

С версии: 3.16

Сигнал “insert-at-cursor”

void
user_function (GtkTextView *text_view,
               char        *string,
               gpointer     user_data)

Сигнал ::insert-at-cursor — это сигнал для привязки клавиш, который генерируется при вставке фиксированной строки в курсор.

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

Флаги: Действие

Сигнал “insert-emoji”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::insert-emoji — это сигнал для привязки клавиш, который генерируется для отображения выбора эмодзи для text_view.

По умолчанию для этого сигнала назначены клавиши Ctrl-. и Ctrl-;

Флаги: Действие

С версии: 3.22.27

Сигнал “move-cursor”

void
user_function (GtkTextView    *text_view,
               GtkMovementStep step,
               int             count,
               gboolean        extend_selection,
               gpointer        user_data)

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

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

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

Флаги: Действие

Сигнал “move-viewport”

void
user_function (GtkTextView  *text_view,
               GtkScrollStep step,
               int           count,
               gpointer      user_data)

Сигнал ::move-viewport — это сигнал привязки клавиш, который можно привязать к комбинациям клавиш для перемещения области просмотра, т.е. изменения части текста, видимой в содержащем прокручиваемом окне.

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

Флаги: Действие

Сигнал “paste-clipboard”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::paste-clipboard — это сигнал привязки клавиш, который генерируется для вставки содержимого буфера обмена в область просмотра текста.

По умолчанию для этого сигнала заданы привязки Ctrl-v и Shift-Insert.

Флаги: Действие

Сигнал “populate-popup”

void
user_function (GtkTextView *text_view,
               GtkWidget   *popup,
               gpointer     user_data)

Сигнал ::populate-popup генерируется перед отображением контекстного меню области просмотра текста.

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

Если свойство «populate-all» равно TRUE, этот сигнал также будет сгенерирован для заполнения всплывающих меню сенсорного экрана. В этом случае popup будет другим контейнером, например, GtkToolbar.

Обработчик сигнала не должен делать предположений о типе widget, а должен проверить, является ли popup GtkMenu, GtkToolbar или другим типом контейнера.

Флаги: Выполнение последним

Сигнал “preedit-changed”

void
user_function (GtkTextView *text_view,
               char        *preedit,
               gpointer     user_data)

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

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

Флаги: Действие

С версии: 2.20

Сигнал “select-all”

void
user_function (GtkTextView *text_view,
               gboolean     select,
               gpointer     user_data)

Сигнал ::select-all — это сигнал привязки клавиш, который генерируется для выбора или отмены выбора всего содержимого области просмотра текста.

По умолчанию для этого сигнала заданы привязки Ctrl-a и Ctrl-/ для выбора и Shift-Ctrl-a и Ctrl-\ для отмены выбора.

Флаги: Действие

Сигнал “set-anchor”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::set-anchor — это сигнал привязки клавиш, который генерируется, когда пользователь начинает устанавливать метку "якорь". Метка "якорь" устанавливается в той же позиции, что и метка "вставка".

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

Флаги: Действие

Сигнал “toggle-cursor-visible”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::toggle-cursor-visible — это сигнал привязки клавиш, который генерируется для переключения свойства «cursor-visible».

По умолчанию для этого сигнала задана привязка F7.

Флаги: Действие

Сигнал “toggle-overwrite”

void
user_function (GtkTextView *text_view,
               gpointer     user_data)

Сигнал ::toggle-overwrite — это сигнал привязки клавиш, который генерируется для переключения режима вставки в области просмотра текста.

По умолчанию для этого сигнала задана привязка Insert.

Флаги: Действие