/* -*- Mode: C; c-file-style: "gnu"; tab-width: 8 -*- */ /* GTK - The GIMP Toolkit * gtktextview.c Copyright (C) 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "config.h" #include "gtktextviewprivate.h" #include #include "gtkadjustmentprivate.h" #include "gtkcsscolorvalueprivate.h" #include "gtkdebug.h" #include "gtkdropcontrollermotion.h" #include "gtkintl.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkrenderbackgroundprivate.h" #include "gtksettings.h" #include "gtktextiterprivate.h" #include "gtkimmulticontext.h" #include "gtkprivate.h" #include "gtktextutil.h" #include "gtkwidgetprivate.h" #include "gtkwindow.h" #include "gtkscrollable.h" #include "gtktypebuiltins.h" #include "gtktextviewchildprivate.h" #include "gtktexthandleprivate.h" #include "gtkcssstylepropertyprivate.h" #include "gtkpopover.h" #include "gtkmagnifierprivate.h" #include "gtkemojichooser.h" #include "gtkpango.h" #include "gtknative.h" #include "gtkwidgetprivate.h" /** * SECTION:gtktextview * @Short_description: Widget that displays a GtkTextBuffer * @Title: GtkTextView * @See_also: #GtkTextBuffer, #GtkTextIter * * You may wish to begin by reading the * [text widget conceptual overview][TextWidget] * which gives an overview of all the objects and data * types related to the text widget and how they work together. * * # CSS nodes * * |[ * textview.view * ├── border.top * ├── border.left * ├── text * │ ╰── [selection] * ├── border.right * ├── border.bottom * ╰── [window.popup] * ]| * * GtkTextView has a main css node with name textview and style class .view, * and subnodes for each of the border windows, and the main text area, * with names border and text, respectively. The border nodes each get * one of the style classes .left, .right, .top or .bottom. * * A node representing the selection will appear below the text node. * * If a context menu is opened, the window node will appear as a subnode * of the main node. * * # Accessibility * * GtkTextView uses the #GTK_ACCESSIBLE_ROLE_TEXT_BOX role. */ /* How scrolling, validation, exposes, etc. work. * * The expose_event handler has the invariant that the onscreen lines * have been validated. * * There are two ways that onscreen lines can become invalid. The first * is to change which lines are onscreen. This happens when the value * of a scroll adjustment changes. So the code path begins in * gtk_text_view_value_changed() and goes like this: * - gdk_surface_scroll() to reflect the new adjustment value * - validate the lines that were moved onscreen * - gdk_surface_process_updates() to handle the exposes immediately * * The second way is that you get the “invalidated” signal from the layout, * indicating that lines have become invalid. This code path begins in * invalidated_handler() and goes like this: * - install high-priority idle which does the rest of the steps * - if a scroll is pending from scroll_to_mark(), do the scroll, * jumping to the gtk_text_view_value_changed() code path * - otherwise, validate the onscreen lines * - DO NOT process updates * * In both cases, validating the onscreen lines can trigger a scroll * due to maintaining the first_para on the top of the screen. * If validation triggers a scroll, we jump to the top of the code path * for value_changed, and bail out of the current code path. * * Also, in size_allocate, if we invalidate some lines from changing * the layout width, we need to go ahead and run the high-priority idle, * because GTK sends exposes right after doing the size allocates without * returning to the main loop. This is also why the high-priority idle * is at a higher priority than resizing. * */ #if 0 #define DEBUG_VALIDATION_AND_SCROLLING #endif #ifdef DEBUG_VALIDATION_AND_SCROLLING #define DV(x) (x) #else #define DV(x) #endif #define SCREEN_WIDTH(widget) text_window_get_width (GTK_TEXT_VIEW (widget)->priv->text_window) #define SCREEN_HEIGHT(widget) text_window_get_height (GTK_TEXT_VIEW (widget)->priv->text_window) #define SPACE_FOR_CURSOR 1 typedef struct _GtkTextWindow GtkTextWindow; typedef struct _GtkTextPendingScroll GtkTextPendingScroll; enum { TEXT_HANDLE_CURSOR, TEXT_HANDLE_SELECTION_BOUND, TEXT_HANDLE_N_HANDLES }; struct _GtkTextViewPrivate { GtkTextLayout *layout; GtkTextBuffer *buffer; guint blink_time; /* time in msec the cursor has blinked since last user event */ guint im_spot_idle; char *im_module; int dnd_x; int dnd_y; GtkTextHandle *text_handles[TEXT_HANDLE_N_HANDLES]; GtkWidget *selection_bubble; guint selection_bubble_timeout_id; GtkWidget *magnifier_popover; GtkWidget *magnifier; GtkBorder border_window_size; GtkTextWindow *text_window; GQueue anchored_children; GtkTextViewChild *left_child; GtkTextViewChild *right_child; GtkTextViewChild *top_child; GtkTextViewChild *bottom_child; GtkTextViewChild *center_child; GtkAdjustment *hadjustment; GtkAdjustment *vadjustment; /* X offset between widget coordinates and buffer coordinates * taking left_padding in account */ int xoffset; /* Y offset between widget coordinates and buffer coordinates * taking top_padding and top_margin in account */ int yoffset; /* Width and height of the buffer */ int width; int height; /* The virtual cursor position is normally the same as the * actual (strong) cursor position, except in two circumstances: * * a) When the cursor is moved vertically with the keyboard * b) When the text view is scrolled with the keyboard * * In case a), virtual_cursor_x is preserved, but not virtual_cursor_y * In case b), both virtual_cursor_x and virtual_cursor_y are preserved. */ int virtual_cursor_x; /* -1 means use actual cursor position */ int virtual_cursor_y; /* -1 means use actual cursor position */ GtkTextMark *first_para_mark; /* Mark at the beginning of the first onscreen paragraph */ int first_para_pixels; /* Offset of top of screen in the first onscreen paragraph */ guint64 blink_start_time; guint blink_tick; float cursor_alpha; guint scroll_timeout; guint first_validate_idle; /* Idle to revalidate onscreen portion, runs before resize */ guint incremental_validate_idle; /* Idle to revalidate offscreen portions, runs after redraw */ GtkTextMark *dnd_mark; GtkIMContext *im_context; GtkWidget *popup_menu; GMenuModel *extra_menu; GtkTextPendingScroll *pending_scroll; GtkGesture *drag_gesture; GtkEventController *key_controller; GtkCssNode *selection_node; GdkDrag *drag; /* Default style settings */ int pixels_above_lines; int pixels_below_lines; int pixels_inside_wrap; GtkWrapMode wrap_mode; GtkJustification justify; int left_margin; int right_margin; int top_margin; int bottom_margin; int left_padding; int right_padding; int top_padding; int bottom_padding; int indent; gint64 handle_place_time; PangoTabArray *tabs; guint editable : 1; guint overwrite_mode : 1; guint cursor_visible : 1; /* if we have reset the IM since the last character entered */ guint need_im_reset : 1; guint accepts_tab : 1; /* debug flag - means that we've validated onscreen since the * last "invalidate" signal from the layout */ guint onscreen_validated : 1; guint mouse_cursor_obscured : 1; guint scroll_after_paste : 1; guint text_handles_enabled : 1; /* GtkScrollablePolicy needs to be checked when * driving the scrollable adjustment values */ guint hscroll_policy : 1; guint vscroll_policy : 1; guint cursor_handle_dragged : 1; guint selection_handle_dragged : 1; }; struct _GtkTextPendingScroll { GtkTextMark *mark; double within_margin; gboolean use_align; double xalign; double yalign; }; typedef enum { SELECT_CHARACTERS, SELECT_WORDS, SELECT_LINES } SelectionGranularity; enum { MOVE_CURSOR, PAGE_HORIZONTALLY, SET_ANCHOR, INSERT_AT_CURSOR, DELETE_FROM_CURSOR, BACKSPACE, CUT_CLIPBOARD, COPY_CLIPBOARD, PASTE_CLIPBOARD, TOGGLE_OVERWRITE, MOVE_VIEWPORT, SELECT_ALL, TOGGLE_CURSOR_VISIBLE, PREEDIT_CHANGED, EXTEND_SELECTION, INSERT_EMOJI, LAST_SIGNAL }; enum { PROP_0, PROP_PIXELS_ABOVE_LINES, PROP_PIXELS_BELOW_LINES, PROP_PIXELS_INSIDE_WRAP, PROP_EDITABLE, PROP_WRAP_MODE, PROP_JUSTIFICATION, PROP_LEFT_MARGIN, PROP_RIGHT_MARGIN, PROP_TOP_MARGIN, PROP_BOTTOM_MARGIN, PROP_INDENT, PROP_TABS, PROP_CURSOR_VISIBLE, PROP_BUFFER, PROP_OVERWRITE, PROP_ACCEPTS_TAB, PROP_IM_MODULE, PROP_HADJUSTMENT, PROP_VADJUSTMENT, PROP_HSCROLL_POLICY, PROP_VSCROLL_POLICY, PROP_INPUT_PURPOSE, PROP_INPUT_HINTS, PROP_MONOSPACE, PROP_EXTRA_MENU }; static GQuark quark_text_selection_data = 0; static GQuark quark_gtk_signal = 0; static GQuark quark_text_view_child = 0; static void gtk_text_view_finalize (GObject *object); static void gtk_text_view_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_text_view_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); static void gtk_text_view_dispose (GObject *object); static void gtk_text_view_measure (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline); static void gtk_text_view_size_allocate (GtkWidget *widget, int width, int height, int baseline); static void gtk_text_view_realize (GtkWidget *widget); static void gtk_text_view_unrealize (GtkWidget *widget); static void gtk_text_view_map (GtkWidget *widget); static void gtk_text_view_css_changed (GtkWidget *widget, GtkCssStyleChange *change); static void gtk_text_view_direction_changed (GtkWidget *widget, GtkTextDirection previous_direction); static void gtk_text_view_state_flags_changed (GtkWidget *widget, GtkStateFlags previous_state); static void gtk_text_view_click_gesture_pressed (GtkGestureClick *gesture, int n_press, double x, double y, GtkTextView *text_view); static void gtk_text_view_drag_gesture_update (GtkGestureDrag *gesture, double offset_x, double offset_y, GtkTextView *text_view); static void gtk_text_view_drag_gesture_end (GtkGestureDrag *gesture, double offset_x, double offset_y, GtkTextView *text_view); static gboolean gtk_text_view_key_controller_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkTextView *text_view); static void gtk_text_view_key_controller_im_update (GtkEventControllerKey *controller, GtkTextView *text_view); static void gtk_text_view_focus_in (GtkWidget *widget); static void gtk_text_view_focus_out (GtkWidget *widget); static void gtk_text_view_motion (GtkEventController *controller, double x, double y, gpointer user_data); static void gtk_text_view_snapshot (GtkWidget *widget, GtkSnapshot *snapshot); static void gtk_text_view_select_all (GtkWidget *widget, gboolean select); static gboolean get_middle_click_paste (GtkTextView *text_view); static GtkTextBuffer* gtk_text_view_create_buffer (GtkTextView *text_view); /* Target side drag signals */ static void gtk_text_view_drag_leave (GtkDropTarget *dest, GtkTextView *text_view); static GdkDragAction gtk_text_view_drag_motion (GtkDropTarget *dest, double x, double y, GtkTextView *text_view); static gboolean gtk_text_view_drag_drop (GtkDropTarget *dest, const GValue *value, double x, double y, GtkTextView *text_view); static void gtk_text_view_popup_menu (GtkWidget *widget, const char *action_name, GVariant *parameters); static void gtk_text_view_move_cursor (GtkTextView *text_view, GtkMovementStep step, int count, gboolean extend_selection); static void gtk_text_view_move_viewport (GtkTextView *text_view, GtkScrollStep step, int count); static void gtk_text_view_set_anchor (GtkTextView *text_view); static gboolean gtk_text_view_scroll_pages (GtkTextView *text_view, int count, gboolean extend_selection); static gboolean gtk_text_view_scroll_hpages(GtkTextView *text_view, int count, gboolean extend_selection); static void gtk_text_view_insert_at_cursor (GtkTextView *text_view, const char *str); static void gtk_text_view_delete_from_cursor (GtkTextView *text_view, GtkDeleteType type, int count); static void gtk_text_view_backspace (GtkTextView *text_view); static void gtk_text_view_cut_clipboard (GtkTextView *text_view); static void gtk_text_view_copy_clipboard (GtkTextView *text_view); static void gtk_text_view_paste_clipboard (GtkTextView *text_view); static void gtk_text_view_toggle_overwrite (GtkTextView *text_view); static void gtk_text_view_toggle_cursor_visible (GtkTextView *text_view); static void gtk_text_view_unselect (GtkTextView *text_view); static void gtk_text_view_validate_onscreen (GtkTextView *text_view); static void gtk_text_view_get_first_para_iter (GtkTextView *text_view, GtkTextIter *iter); static void gtk_text_view_update_layout_width (GtkTextView *text_view); static void gtk_text_view_set_attributes_from_style (GtkTextView *text_view, GtkTextAttributes *values); static void gtk_text_view_ensure_layout (GtkTextView *text_view); static void gtk_text_view_destroy_layout (GtkTextView *text_view); static void gtk_text_view_check_keymap_direction (GtkTextView *text_view); static void gtk_text_view_start_selection_drag (GtkTextView *text_view, const GtkTextIter *iter, SelectionGranularity granularity, gboolean extends); static gboolean gtk_text_view_end_selection_drag (GtkTextView *text_view); static void gtk_text_view_start_selection_dnd (GtkTextView *text_view, const GtkTextIter *iter, GdkEvent *event, int x, int y); static void gtk_text_view_check_cursor_blink (GtkTextView *text_view); static void gtk_text_view_pend_cursor_blink (GtkTextView *text_view); static void gtk_text_view_stop_cursor_blink (GtkTextView *text_view); static void gtk_text_view_reset_blink_time (GtkTextView *text_view); static void gtk_text_view_value_changed (GtkAdjustment *adjustment, GtkTextView *view); static void gtk_text_view_commit_handler (GtkIMContext *context, const char *str, GtkTextView *text_view); static void gtk_text_view_commit_text (GtkTextView *text_view, const char *text); static void gtk_text_view_preedit_changed_handler (GtkIMContext *context, GtkTextView *text_view); static gboolean gtk_text_view_retrieve_surrounding_handler (GtkIMContext *context, GtkTextView *text_view); static gboolean gtk_text_view_delete_surrounding_handler (GtkIMContext *context, int offset, int n_chars, GtkTextView *text_view); static void gtk_text_view_mark_set_handler (GtkTextBuffer *buffer, const GtkTextIter *location, GtkTextMark *mark, gpointer data); static void gtk_text_view_paste_done_handler (GtkTextBuffer *buffer, GdkClipboard *clipboard, gpointer data); static void gtk_text_view_buffer_changed_handler (GtkTextBuffer *buffer, gpointer data); static void gtk_text_view_buffer_notify_redo (GtkTextBuffer *buffer, GParamSpec *pspec, GtkTextView *view); static void gtk_text_view_buffer_notify_undo (GtkTextBuffer *buffer, GParamSpec *pspec, GtkTextView *view); static void gtk_text_view_get_virtual_cursor_pos (GtkTextView *text_view, GtkTextIter *cursor, int *x, int *y); static void gtk_text_view_set_virtual_cursor_pos (GtkTextView *text_view, int x, int y); static void gtk_text_view_do_popup (GtkTextView *text_view, GdkEvent *event); static void cancel_pending_scroll (GtkTextView *text_view); static void gtk_text_view_queue_scroll (GtkTextView *text_view, GtkTextMark *mark, double within_margin, gboolean use_align, double xalign, double yalign); static gboolean gtk_text_view_flush_scroll (GtkTextView *text_view); static void gtk_text_view_update_adjustments (GtkTextView *text_view); static void gtk_text_view_invalidate (GtkTextView *text_view); static void gtk_text_view_flush_first_validate (GtkTextView *text_view); static void gtk_text_view_set_hadjustment (GtkTextView *text_view, GtkAdjustment *adjustment); static void gtk_text_view_set_vadjustment (GtkTextView *text_view, GtkAdjustment *adjustment); static void gtk_text_view_set_hadjustment_values (GtkTextView *text_view); static void gtk_text_view_set_vadjustment_values (GtkTextView *text_view); static void gtk_text_view_update_im_spot_location (GtkTextView *text_view); static void gtk_text_view_insert_emoji (GtkTextView *text_view); static void update_node_ordering (GtkWidget *widget); /* GtkTextHandle handlers */ static void gtk_text_view_handle_drag_started (GtkTextHandle *handle, GtkTextView *text_view); static void gtk_text_view_handle_dragged (GtkTextHandle *handle, int x, int y, GtkTextView *text_view); static void gtk_text_view_handle_drag_finished (GtkTextHandle *handle, GtkTextView *text_view); static void gtk_text_view_update_handles (GtkTextView *text_view); static void gtk_text_view_selection_bubble_popup_unset (GtkTextView *text_view); static void gtk_text_view_selection_bubble_popup_set (GtkTextView *text_view); static gboolean gtk_text_view_extend_selection (GtkTextView *text_view, GtkTextExtendSelection granularity, const GtkTextIter *location, GtkTextIter *start, GtkTextIter *end); static void extend_selection (GtkTextView *text_view, SelectionGranularity granularity, const GtkTextIter *location, GtkTextIter *start, GtkTextIter *end); static void gtk_text_view_update_clipboard_actions (GtkTextView *text_view); static void gtk_text_view_update_emoji_action (GtkTextView *text_view); static void gtk_text_view_activate_clipboard_cut (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_activate_clipboard_copy (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_activate_clipboard_paste (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_activate_selection_delete (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_activate_selection_select_all (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_activate_misc_insert_emoji (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_real_undo (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_text_view_real_redo (GtkWidget *widget, const char *action_name, GVariant *parameter); /* FIXME probably need the focus methods. */ typedef struct { GList link; GtkWidget *widget; GtkTextChildAnchor *anchor; int from_top_of_line; int from_left_of_buffer; } AnchoredChild; static AnchoredChild *anchored_child_new (GtkWidget *child, GtkTextChildAnchor *anchor, GtkTextLayout *layout); static void anchored_child_free (AnchoredChild *child); struct _GtkTextWindow { GtkTextWindowType type; GtkWidget *widget; GtkCssNode *css_node; GdkRectangle allocation; }; static GtkTextWindow *text_window_new (GtkWidget *widget); static void text_window_free (GtkTextWindow *win); static void text_window_size_allocate (GtkTextWindow *win, GdkRectangle *rect); static int text_window_get_width (GtkTextWindow *win); static int text_window_get_height (GtkTextWindow *win); static guint signals[LAST_SIGNAL] = { 0 }; G_DEFINE_TYPE_WITH_CODE (GtkTextView, gtk_text_view, GTK_TYPE_WIDGET, G_ADD_PRIVATE (GtkTextView) G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL)) static GtkTextBuffer* get_buffer (GtkTextView *text_view) { if (text_view->priv->buffer == NULL) { GtkTextBuffer *b; b = GTK_TEXT_VIEW_GET_CLASS (text_view)->create_buffer (text_view); gtk_text_view_set_buffer (text_view, b); g_object_unref (b); } return text_view->priv->buffer; } #define UPPER_OFFSET_ANCHOR 0.8 #define LOWER_OFFSET_ANCHOR 0.2 static gboolean check_scroll (double offset, GtkAdjustment *adjustment) { if ((offset > UPPER_OFFSET_ANCHOR && gtk_adjustment_get_value (adjustment) + gtk_adjustment_get_page_size (adjustment) < gtk_adjustment_get_upper (adjustment)) || (offset < LOWER_OFFSET_ANCHOR && gtk_adjustment_get_value (adjustment) > gtk_adjustment_get_lower (adjustment))) return TRUE; return FALSE; } static int gtk_text_view_drop_motion_scroll_timeout (gpointer data) { GtkTextView *text_view; GtkTextViewPrivate *priv; GtkTextIter newplace; double pointer_xoffset, pointer_yoffset; text_view = GTK_TEXT_VIEW (data); priv = text_view->priv; gtk_text_layout_get_iter_at_pixel (priv->layout, &newplace, priv->dnd_x + priv->xoffset, priv->dnd_y + priv->yoffset); gtk_text_buffer_move_mark (get_buffer (text_view), priv->dnd_mark, &newplace); pointer_xoffset = (double) priv->dnd_x / text_window_get_width (priv->text_window); pointer_yoffset = (double) priv->dnd_y / text_window_get_height (priv->text_window); if (check_scroll (pointer_xoffset, priv->hadjustment) || check_scroll (pointer_yoffset, priv->vadjustment)) { /* do not make offsets surpass lower nor upper anchors, this makes * scrolling speed relative to the distance of the pointer to the * anchors when it moves beyond them. */ pointer_xoffset = CLAMP (pointer_xoffset, LOWER_OFFSET_ANCHOR, UPPER_OFFSET_ANCHOR); pointer_yoffset = CLAMP (pointer_yoffset, LOWER_OFFSET_ANCHOR, UPPER_OFFSET_ANCHOR); gtk_text_view_scroll_to_mark (text_view, priv->dnd_mark, 0., TRUE, pointer_xoffset, pointer_yoffset); } return G_SOURCE_CONTINUE; } static void gtk_text_view_drop_scroll_motion (GtkDropControllerMotion *motion, double x, double y, GtkTextView *self) { GtkTextViewPrivate *priv = self->priv; GdkRectangle target_rect; target_rect = priv->text_window->allocation; if (x < target_rect.x || y < target_rect.y || x > (target_rect.x + target_rect.width) || y > (target_rect.y + target_rect.height)) { priv->dnd_x = priv->dnd_y = -1; g_clear_handle_id (&priv->scroll_timeout, g_source_remove); return; } /* DnD uses text window coords, so subtract extra widget * coords that happen e.g. when displaying line numbers. */ priv->dnd_x = x - target_rect.x; priv->dnd_y = y - target_rect.y; if (!priv->scroll_timeout) { priv->scroll_timeout = g_timeout_add (100, gtk_text_view_drop_motion_scroll_timeout, self); g_source_set_name_by_id (priv->scroll_timeout, "[gtk] gtk_text_view_drop_motion_scroll_timeout"); } } static void gtk_text_view_drop_scroll_leave (GtkDropControllerMotion *motion, GtkTextView *self) { GtkTextViewPrivate *priv = self->priv; priv->dnd_x = priv->dnd_y = -1; g_clear_handle_id (&priv->scroll_timeout, g_source_remove); } static void add_move_binding (GtkWidgetClass *widget_class, guint keyval, guint modmask, GtkMovementStep step, int count) { g_assert ((modmask & GDK_SHIFT_MASK) == 0); gtk_widget_class_add_binding_signal (widget_class, keyval, modmask, "move-cursor", "(iib)", step, count, FALSE); /* Selection-extending version */ gtk_widget_class_add_binding_signal (widget_class, keyval, modmask | GDK_SHIFT_MASK, "move-cursor", "(iib)", step, count, TRUE); } static void gtk_text_view_class_init (GtkTextViewClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); /* Default handlers and virtual methods */ gobject_class->set_property = gtk_text_view_set_property; gobject_class->get_property = gtk_text_view_get_property; gobject_class->finalize = gtk_text_view_finalize; gobject_class->dispose = gtk_text_view_dispose; widget_class->realize = gtk_text_view_realize; widget_class->unrealize = gtk_text_view_unrealize; widget_class->map = gtk_text_view_map; widget_class->css_changed = gtk_text_view_css_changed; widget_class->direction_changed = gtk_text_view_direction_changed; widget_class->state_flags_changed = gtk_text_view_state_flags_changed; widget_class->measure = gtk_text_view_measure; widget_class->size_allocate = gtk_text_view_size_allocate; widget_class->snapshot = gtk_text_view_snapshot; klass->move_cursor = gtk_text_view_move_cursor; klass->set_anchor = gtk_text_view_set_anchor; klass->insert_at_cursor = gtk_text_view_insert_at_cursor; klass->delete_from_cursor = gtk_text_view_delete_from_cursor; klass->backspace = gtk_text_view_backspace; klass->cut_clipboard = gtk_text_view_cut_clipboard; klass->copy_clipboard = gtk_text_view_copy_clipboard; klass->paste_clipboard = gtk_text_view_paste_clipboard; klass->toggle_overwrite = gtk_text_view_toggle_overwrite; klass->create_buffer = gtk_text_view_create_buffer; klass->extend_selection = gtk_text_view_extend_selection; klass->insert_emoji = gtk_text_view_insert_emoji; /* * Properties */ g_object_class_install_property (gobject_class, PROP_PIXELS_ABOVE_LINES, g_param_spec_int ("pixels-above-lines", P_("Pixels Above Lines"), P_("Pixels of blank space above paragraphs"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_PIXELS_BELOW_LINES, g_param_spec_int ("pixels-below-lines", P_("Pixels Below Lines"), P_("Pixels of blank space below paragraphs"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_PIXELS_INSIDE_WRAP, g_param_spec_int ("pixels-inside-wrap", P_("Pixels Inside Wrap"), P_("Pixels of blank space between wrapped lines in a paragraph"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_EDITABLE, g_param_spec_boolean ("editable", P_("Editable"), P_("Whether the text can be modified by the user"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_WRAP_MODE, g_param_spec_enum ("wrap-mode", P_("Wrap Mode"), P_("Whether to wrap lines never, at word boundaries, or at character boundaries"), GTK_TYPE_WRAP_MODE, GTK_WRAP_NONE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_JUSTIFICATION, g_param_spec_enum ("justification", P_("Justification"), P_("Left, right, or center justification"), GTK_TYPE_JUSTIFICATION, GTK_JUSTIFY_LEFT, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:left-margin: * * The default left margin for text in the text view. * Tags in the buffer may override the default. * * Note that this property is confusingly named. In CSS terms, * the value set here is padding, and it is applied in addition * to the padding from the theme. */ g_object_class_install_property (gobject_class, PROP_LEFT_MARGIN, g_param_spec_int ("left-margin", P_("Left Margin"), P_("Width of the left margin in pixels"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:right-margin: * * The default right margin for text in the text view. * Tags in the buffer may override the default. * * Note that this property is confusingly named. In CSS terms, * the value set here is padding, and it is applied in addition * to the padding from the theme. */ g_object_class_install_property (gobject_class, PROP_RIGHT_MARGIN, g_param_spec_int ("right-margin", P_("Right Margin"), P_("Width of the right margin in pixels"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:top-margin: * * The top margin for text in the text view. * * Note that this property is confusingly named. In CSS terms, * the value set here is padding, and it is applied in addition * to the padding from the theme. * * Don't confuse this property with #GtkWidget:margin-top. */ g_object_class_install_property (gobject_class, PROP_TOP_MARGIN, g_param_spec_int ("top-margin", P_("Top Margin"), P_("Height of the top margin in pixels"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:bottom-margin: * * The bottom margin for text in the text view. * * Note that this property is confusingly named. In CSS terms, * the value set here is padding, and it is applied in addition * to the padding from the theme. * * Don't confuse this property with #GtkWidget:margin-bottom. */ g_object_class_install_property (gobject_class, PROP_BOTTOM_MARGIN, g_param_spec_int ("bottom-margin", P_("Bottom Margin"), P_("Height of the bottom margin in pixels"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_INDENT, g_param_spec_int ("indent", P_("Indent"), P_("Amount to indent the paragraph, in pixels"), G_MININT, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_TABS, g_param_spec_boxed ("tabs", P_("Tabs"), P_("Custom tabs for this text"), PANGO_TYPE_TAB_ARRAY, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_CURSOR_VISIBLE, g_param_spec_boolean ("cursor-visible", P_("Cursor Visible"), P_("If the insertion cursor is shown"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_BUFFER, g_param_spec_object ("buffer", P_("Buffer"), P_("The buffer which is displayed"), GTK_TYPE_TEXT_BUFFER, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_OVERWRITE, g_param_spec_boolean ("overwrite", P_("Overwrite mode"), P_("Whether entered text overwrites existing contents"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_ACCEPTS_TAB, g_param_spec_boolean ("accepts-tab", P_("Accepts tab"), P_("Whether Tab will result in a tab character being entered"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:im-module: * * Which IM (input method) module should be used for this text_view. * See #GtkIMContext. * * Setting this to a non-%NULL value overrides the * system-wide IM module setting. See the GtkSettings * #GtkSettings:gtk-im-module property. */ g_object_class_install_property (gobject_class, PROP_IM_MODULE, g_param_spec_string ("im-module", P_("IM module"), P_("Which IM module should be used"), NULL, GTK_PARAM_READWRITE)); /** * GtkTextView:input-purpose: * * The purpose of this text field. * * This property can be used by on-screen keyboards and other input * methods to adjust their behaviour. */ g_object_class_install_property (gobject_class, PROP_INPUT_PURPOSE, g_param_spec_enum ("input-purpose", P_("Purpose"), P_("Purpose of the text field"), GTK_TYPE_INPUT_PURPOSE, GTK_INPUT_PURPOSE_FREE_FORM, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:input-hints: * * Additional hints (beyond #GtkTextView:input-purpose) that * allow input methods to fine-tune their behaviour. */ g_object_class_install_property (gobject_class, PROP_INPUT_HINTS, g_param_spec_flags ("input-hints", P_("hints"), P_("Hints for the text field behaviour"), GTK_TYPE_INPUT_HINTS, GTK_INPUT_HINT_NONE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkTextView:monospace: * * If %TRUE, set the .monospace style class on the * text view to indicate that a monospace font is desired. */ g_object_class_install_property (gobject_class, PROP_MONOSPACE, g_param_spec_boolean ("monospace", P_("Monospace"), P_("Whether to use a monospace font"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_EXTRA_MENU, g_param_spec_object ("extra-menu", P_("Extra menu"), P_("Menu model to append to the context menu"), G_TYPE_MENU_MODEL, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /* GtkScrollable interface */ g_object_class_override_property (gobject_class, PROP_HADJUSTMENT, "hadjustment"); g_object_class_override_property (gobject_class, PROP_VADJUSTMENT, "vadjustment"); g_object_class_override_property (gobject_class, PROP_HSCROLL_POLICY, "hscroll-policy"); g_object_class_override_property (gobject_class, PROP_VSCROLL_POLICY, "vscroll-policy"); /* * Signals */ /** * GtkTextView::move-cursor: * @text_view: the object which received the signal * @step: the granularity of the move, as a #GtkMovementStep * @count: the number of @step units to move * @extend_selection: %TRUE if the move should extend the selection * * The ::move-cursor signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user initiates a cursor movement. * If the cursor is not visible in @text_view, this signal causes * the viewport to be moved instead. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control the cursor * programmatically. * * The default bindings for this signal come in two variants, * the variant with the Shift modifier extends the selection, * the variant without the Shift modifier does not. * There are too many key combinations to list them all here. * - Arrow keys move by individual characters/lines * - Ctrl-arrow key combinations move by words/paragraphs * - Home/End keys move to the ends of the buffer * - PageUp/PageDown keys move vertically by pages * - Ctrl-PageUp/PageDown keys move horizontally by pages */ signals[MOVE_CURSOR] = g_signal_new (I_("move-cursor"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, move_cursor), NULL, NULL, _gtk_marshal_VOID__ENUM_INT_BOOLEAN, G_TYPE_NONE, 3, GTK_TYPE_MOVEMENT_STEP, G_TYPE_INT, G_TYPE_BOOLEAN); g_signal_set_va_marshaller (signals[MOVE_CURSOR], G_OBJECT_CLASS_TYPE (gobject_class), _gtk_marshal_VOID__ENUM_INT_BOOLEANv); /** * GtkTextView::move-viewport: * @text_view: the object which received the signal * @step: the granularity of the movement, as a #GtkScrollStep * @count: the number of @step units to move * * The ::move-viewport signal is a * [keybinding signal][GtkBindingSignal] * which can be bound to key combinations to allow the user * to move the viewport, i.e. change what part of the text view * is visible in a containing scrolled window. * * There are no default bindings for this signal. */ signals[MOVE_VIEWPORT] = g_signal_new_class_handler (I_("move-viewport"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_CALLBACK (gtk_text_view_move_viewport), NULL, NULL, _gtk_marshal_VOID__ENUM_INT, G_TYPE_NONE, 2, GTK_TYPE_SCROLL_STEP, G_TYPE_INT); g_signal_set_va_marshaller (signals[MOVE_VIEWPORT], G_OBJECT_CLASS_TYPE (gobject_class), _gtk_marshal_VOID__ENUM_INTv); /** * GtkTextView::set-anchor: * @text_view: the object which received the signal * * The ::set-anchor signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user initiates setting the "anchor" * mark. The "anchor" mark gets placed at the same position as the * "insert" mark. * * This signal has no default bindings. */ signals[SET_ANCHOR] = g_signal_new (I_("set-anchor"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, set_anchor), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::insert-at-cursor: * @text_view: the object which received the signal * @string: the string to insert * * The ::insert-at-cursor signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user initiates the insertion of a * fixed string at the cursor. * * This signal has no default bindings. */ signals[INSERT_AT_CURSOR] = g_signal_new (I_("insert-at-cursor"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, insert_at_cursor), NULL, NULL, NULL, G_TYPE_NONE, 1, G_TYPE_STRING); /** * GtkTextView::delete-from-cursor: * @text_view: the object which received the signal * @type: the granularity of the deletion, as a #GtkDeleteType * @count: the number of @type units to delete * * The ::delete-from-cursor signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user initiates a text deletion. * * If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection * if there is one, otherwise it deletes the requested number * of characters. * * The default bindings for this signal are * Delete for deleting a character, Ctrl-Delete for * deleting a word and Ctrl-Backspace for deleting a word * backwards. */ signals[DELETE_FROM_CURSOR] = g_signal_new (I_("delete-from-cursor"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, delete_from_cursor), NULL, NULL, _gtk_marshal_VOID__ENUM_INT, G_TYPE_NONE, 2, GTK_TYPE_DELETE_TYPE, G_TYPE_INT); g_signal_set_va_marshaller (signals[DELETE_FROM_CURSOR], G_OBJECT_CLASS_TYPE (gobject_class), _gtk_marshal_VOID__ENUM_INTv); /** * GtkTextView::backspace: * @text_view: the object which received the signal * * The ::backspace signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user asks for it. * * The default bindings for this signal are * Backspace and Shift-Backspace. */ signals[BACKSPACE] = g_signal_new (I_("backspace"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, backspace), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::cut-clipboard: * @text_view: the object which received the signal * * The ::cut-clipboard signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to cut the selection to the clipboard. * * The default bindings for this signal are * Ctrl-x and Shift-Delete. */ signals[CUT_CLIPBOARD] = g_signal_new (I_("cut-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, cut_clipboard), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::copy-clipboard: * @text_view: the object which received the signal * * The ::copy-clipboard signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to copy the selection to the clipboard. * * The default bindings for this signal are * Ctrl-c and Ctrl-Insert. */ signals[COPY_CLIPBOARD] = g_signal_new (I_("copy-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, copy_clipboard), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::paste-clipboard: * @text_view: the object which received the signal * * The ::paste-clipboard signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to paste the contents of the clipboard * into the text view. * * The default bindings for this signal are * Ctrl-v and Shift-Insert. */ signals[PASTE_CLIPBOARD] = g_signal_new (I_("paste-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, paste_clipboard), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::toggle-overwrite: * @text_view: the object which received the signal * * The ::toggle-overwrite signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to toggle the overwrite mode of the text view. * * The default bindings for this signal is Insert. */ signals[TOGGLE_OVERWRITE] = g_signal_new (I_("toggle-overwrite"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, toggle_overwrite), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::select-all: * @text_view: the object which received the signal * @select: %TRUE to select, %FALSE to unselect * * The ::select-all signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to select or unselect the complete * contents of the text view. * * The default bindings for this signal are Ctrl-a and Ctrl-/ * for selecting and Shift-Ctrl-a and Ctrl-\ for unselecting. */ signals[SELECT_ALL] = g_signal_new_class_handler (I_("select-all"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_CALLBACK (gtk_text_view_select_all), NULL, NULL, NULL, G_TYPE_NONE, 1, G_TYPE_BOOLEAN); /** * GtkTextView::toggle-cursor-visible: * @text_view: the object which received the signal * * The ::toggle-cursor-visible signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to toggle the #GtkTextView:cursor-visible * property. * * The default binding for this signal is F7. */ signals[TOGGLE_CURSOR_VISIBLE] = g_signal_new_class_handler (I_("toggle-cursor-visible"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_CALLBACK (gtk_text_view_toggle_cursor_visible), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkTextView::preedit-changed: * @text_view: the object which received the signal * @preedit: the current preedit string * * If an input method is used, the typed text will not immediately * be committed to the buffer. So if you are interested in the text, * connect to this signal. * * This signal is only emitted if the text at the given position * is actually editable. */ signals[PREEDIT_CHANGED] = g_signal_new_class_handler (I_("preedit-changed"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, NULL, NULL, NULL, NULL, G_TYPE_NONE, 1, G_TYPE_STRING); /** * GtkTextView::extend-selection: * @text_view: the object which received the signal * @granularity: the granularity type * @location: the location where to extend the selection * @start: where the selection should start * @end: where the selection should end * * The ::extend-selection signal is emitted when the selection needs to be * extended at @location. * * Returns: %GDK_EVENT_STOP to stop other handlers from being invoked for the * event. %GDK_EVENT_PROPAGATE to propagate the event further. */ signals[EXTEND_SELECTION] = g_signal_new (I_("extend-selection"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkTextViewClass, extend_selection), _gtk_boolean_handled_accumulator, NULL, _gtk_marshal_BOOLEAN__ENUM_BOXED_BOXED_BOXED, G_TYPE_BOOLEAN, 4, GTK_TYPE_TEXT_EXTEND_SELECTION, GTK_TYPE_TEXT_ITER | G_SIGNAL_TYPE_STATIC_SCOPE, GTK_TYPE_TEXT_ITER | G_SIGNAL_TYPE_STATIC_SCOPE, GTK_TYPE_TEXT_ITER | G_SIGNAL_TYPE_STATIC_SCOPE); g_signal_set_va_marshaller (signals[EXTEND_SELECTION], G_TYPE_FROM_CLASS (klass), _gtk_marshal_BOOLEAN__ENUM_BOXED_BOXED_BOXEDv); /** * GtkTextView::insert-emoji: * @text_view: the object which received the signal * * The ::insert-emoji signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted to present the Emoji chooser for the @text_view. * * The default bindings for this signal are Ctrl-. and Ctrl-; */ signals[INSERT_EMOJI] = g_signal_new (I_("insert-emoji"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, insert_emoji), NULL, NULL, NULL, G_TYPE_NONE, 0); /* * Actions */ /** * GtkTextView|clipboard.cut: * * Copies the contents to the clipboard and deletes it from the widget. */ gtk_widget_class_install_action (widget_class, "clipboard.cut", NULL, gtk_text_view_activate_clipboard_cut); /** * GtkTextView|clipboard.copy: * * Copies the contents to the clipboard. */ gtk_widget_class_install_action (widget_class, "clipboard.copy", NULL, gtk_text_view_activate_clipboard_copy); /** * GtkTextView|clipboard.paste: * * Inserts the contents of the clipboard into the widget. */ gtk_widget_class_install_action (widget_class, "clipboard.paste", NULL, gtk_text_view_activate_clipboard_paste); /** * GtkTextView|selection.delete: * * Deletes the current selection. */ gtk_widget_class_install_action (widget_class, "selection.delete", NULL, gtk_text_view_activate_selection_delete); /** * GtkTextView|selection.select-all: * * Selects all of the widgets content. */ gtk_widget_class_install_action (widget_class, "selection.select-all", NULL, gtk_text_view_activate_selection_select_all); /** * GtkTextView|misc.insert-emoji: * * Opens the Emoji chooser. */ gtk_widget_class_install_action (widget_class, "misc.insert-emoji", NULL, gtk_text_view_activate_misc_insert_emoji); /** * GtkTextView|text.undo: * * Undoes the last change to the contents. */ gtk_widget_class_install_action (widget_class, "text.undo", NULL, gtk_text_view_real_undo); /** * GtkTextView|text.redo: * * Redoes the last change to the contents. */ gtk_widget_class_install_action (widget_class, "text.redo", NULL, gtk_text_view_real_redo); /** * GtkTextView|menu.popup: * * Opens the context menu. */ gtk_widget_class_install_action (widget_class, "menu.popup", NULL, gtk_text_view_popup_menu); /* * Key bindings */ gtk_widget_class_add_binding_action (widget_class, GDK_KEY_F10, GDK_SHIFT_MASK, "menu.popup", NULL); gtk_widget_class_add_binding_action (widget_class, GDK_KEY_Menu, 0, "menu.popup", NULL); /* Moving the insertion point */ add_move_binding (widget_class, GDK_KEY_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (widget_class, GDK_KEY_KP_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (widget_class, GDK_KEY_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (widget_class, GDK_KEY_KP_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (widget_class, GDK_KEY_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (widget_class, GDK_KEY_KP_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (widget_class, GDK_KEY_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (widget_class, GDK_KEY_KP_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (widget_class, GDK_KEY_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); add_move_binding (widget_class, GDK_KEY_KP_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); add_move_binding (widget_class, GDK_KEY_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); add_move_binding (widget_class, GDK_KEY_KP_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); add_move_binding (widget_class, GDK_KEY_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, -1); add_move_binding (widget_class, GDK_KEY_KP_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, -1); add_move_binding (widget_class, GDK_KEY_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, 1); add_move_binding (widget_class, GDK_KEY_KP_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, 1); add_move_binding (widget_class, GDK_KEY_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (widget_class, GDK_KEY_KP_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (widget_class, GDK_KEY_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (widget_class, GDK_KEY_KP_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (widget_class, GDK_KEY_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (widget_class, GDK_KEY_KP_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (widget_class, GDK_KEY_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); add_move_binding (widget_class, GDK_KEY_KP_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); add_move_binding (widget_class, GDK_KEY_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); add_move_binding (widget_class, GDK_KEY_KP_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); add_move_binding (widget_class, GDK_KEY_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); add_move_binding (widget_class, GDK_KEY_KP_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); add_move_binding (widget_class, GDK_KEY_Page_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, -1); add_move_binding (widget_class, GDK_KEY_KP_Page_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, -1); add_move_binding (widget_class, GDK_KEY_Page_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, 1); add_move_binding (widget_class, GDK_KEY_KP_Page_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, 1); /* Select all */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_a, GDK_CONTROL_MASK, "select-all", "(b)", TRUE); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_slash, GDK_CONTROL_MASK, "select-all", "(b)", TRUE); /* Unselect all */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_backslash, GDK_CONTROL_MASK, "select-all", "(b)", FALSE); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_a, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "select-all", "(b)", FALSE); /* Deleting text */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Delete, 0, "delete-from-cursor", "(ii)", GTK_DELETE_CHARS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Delete, 0, "delete-from-cursor", "(ii)", GTK_DELETE_CHARS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_BackSpace, 0, "backspace", NULL); /* Make this do the same as Backspace, to help with mis-typing */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_BackSpace, GDK_SHIFT_MASK, "backspace", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Delete, GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_WORD_ENDS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Delete, GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_WORD_ENDS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_BackSpace, GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_WORD_ENDS, -1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Delete, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_PARAGRAPH_ENDS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Delete, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_PARAGRAPH_ENDS, 1); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_BackSpace, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", "(ii)", GTK_DELETE_PARAGRAPH_ENDS, -1); /* Cut/copy/paste */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_x, GDK_CONTROL_MASK, "cut-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_c, GDK_CONTROL_MASK, "copy-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_v, GDK_CONTROL_MASK, "paste-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Delete, GDK_SHIFT_MASK, "cut-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Insert, GDK_CONTROL_MASK, "copy-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Insert, GDK_SHIFT_MASK, "paste-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Delete, GDK_SHIFT_MASK, "cut-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Insert, GDK_CONTROL_MASK, "copy-clipboard", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Insert, GDK_SHIFT_MASK, "paste-clipboard", NULL); /* Undo/Redo */ gtk_widget_class_add_binding_action (widget_class, GDK_KEY_z, GDK_CONTROL_MASK, "text.undo", NULL); gtk_widget_class_add_binding_action (widget_class, GDK_KEY_y, GDK_CONTROL_MASK, "text.redo", NULL); gtk_widget_class_add_binding_action (widget_class, GDK_KEY_z, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "text.redo", NULL); /* Overwrite */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Insert, 0, "toggle-overwrite", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Insert, 0, "toggle-overwrite", NULL); /* Emoji */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_period, GDK_CONTROL_MASK, "insert-emoji", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_semicolon, GDK_CONTROL_MASK, "insert-emoji", NULL); /* Caret mode */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_F7, 0, "toggle-cursor-visible", NULL); /* Control-tab focus motion */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Tab, GDK_CONTROL_MASK, "move-focus", "(i)", GTK_DIR_TAB_FORWARD); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Tab, GDK_CONTROL_MASK, "move-focus", "(i)", GTK_DIR_TAB_FORWARD); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Tab, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "move-focus", "(i)", GTK_DIR_TAB_BACKWARD); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Tab, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "move-focus", "(i)", GTK_DIR_TAB_BACKWARD); gtk_widget_class_set_css_name (widget_class, I_("textview")); gtk_widget_class_set_accessible_role (widget_class, GTK_ACCESSIBLE_ROLE_TEXT_BOX); quark_text_selection_data = g_quark_from_static_string ("gtk-text-view-text-selection-data"); quark_gtk_signal = g_quark_from_static_string ("gtk-signal"); quark_text_view_child = g_quark_from_static_string ("gtk-text-view-child"); } static void _gtk_text_view_ensure_text_handles (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; int i; for (i = 0; i < TEXT_HANDLE_N_HANDLES; i++) { if (priv->text_handles[i]) continue; priv->text_handles[i] = gtk_text_handle_new (GTK_WIDGET (text_view)); g_signal_connect (priv->text_handles[i], "drag-started", G_CALLBACK (gtk_text_view_handle_drag_started), text_view); g_signal_connect (priv->text_handles[i], "handle-dragged", G_CALLBACK (gtk_text_view_handle_dragged), text_view); g_signal_connect (priv->text_handles[i], "drag-finished", G_CALLBACK (gtk_text_view_handle_drag_finished), text_view); } } static void gtk_text_view_init (GtkTextView *text_view) { GtkWidget *widget = GTK_WIDGET (text_view); GtkDropTarget *dest; GtkTextViewPrivate *priv; GtkEventController *controller; GtkGesture *gesture; text_view->priv = gtk_text_view_get_instance_private (text_view); priv = text_view->priv; gtk_widget_set_focusable (widget, TRUE); gtk_widget_set_overflow (widget, GTK_OVERFLOW_HIDDEN); gtk_widget_add_css_class (widget, "view"); gtk_widget_set_cursor_from_name (widget, "text"); /* Set up default style */ priv->wrap_mode = GTK_WRAP_NONE; priv->pixels_above_lines = 0; priv->pixels_below_lines = 0; priv->pixels_inside_wrap = 0; priv->justify = GTK_JUSTIFY_LEFT; priv->indent = 0; priv->tabs = NULL; priv->editable = TRUE; priv->cursor_alpha = 1.0; priv->scroll_after_paste = FALSE; dest = gtk_drop_target_new (G_TYPE_STRING, GDK_ACTION_COPY | GDK_ACTION_MOVE); g_signal_connect (dest, "enter", G_CALLBACK (gtk_text_view_drag_motion), text_view); g_signal_connect (dest, "motion", G_CALLBACK (gtk_text_view_drag_motion), text_view); g_signal_connect (dest, "leave", G_CALLBACK (gtk_text_view_drag_leave), text_view); g_signal_connect (dest, "drop", G_CALLBACK (gtk_text_view_drag_drop), text_view); gtk_widget_add_controller (GTK_WIDGET (text_view), GTK_EVENT_CONTROLLER (dest)); controller = gtk_drop_controller_motion_new (); g_signal_connect (controller, "enter", G_CALLBACK (gtk_text_view_drop_scroll_motion), text_view); g_signal_connect (controller, "motion", G_CALLBACK (gtk_text_view_drop_scroll_motion), text_view); g_signal_connect (controller, "leave", G_CALLBACK (gtk_text_view_drop_scroll_leave), text_view); gtk_widget_add_controller (GTK_WIDGET (text_view), controller); priv->virtual_cursor_x = -1; priv->virtual_cursor_y = -1; /* This object is completely private. No external entity can gain a reference * to it; so we create it here and destroy it in finalize (). */ priv->im_context = gtk_im_multicontext_new (); g_signal_connect (priv->im_context, "commit", G_CALLBACK (gtk_text_view_commit_handler), text_view); g_signal_connect (priv->im_context, "preedit-changed", G_CALLBACK (gtk_text_view_preedit_changed_handler), text_view); g_signal_connect (priv->im_context, "retrieve-surrounding", G_CALLBACK (gtk_text_view_retrieve_surrounding_handler), text_view); g_signal_connect (priv->im_context, "delete-surrounding", G_CALLBACK (gtk_text_view_delete_surrounding_handler), text_view); priv->cursor_visible = TRUE; priv->accepts_tab = TRUE; priv->text_window = text_window_new (widget); gesture = gtk_gesture_click_new (); gtk_gesture_single_set_button (GTK_GESTURE_SINGLE (gesture), 0); g_signal_connect (gesture, "pressed", G_CALLBACK (gtk_text_view_click_gesture_pressed), widget); gtk_widget_add_controller (widget, GTK_EVENT_CONTROLLER (gesture)); priv->drag_gesture = gtk_gesture_drag_new (); g_signal_connect (priv->drag_gesture, "drag-update", G_CALLBACK (gtk_text_view_drag_gesture_update), widget); g_signal_connect (priv->drag_gesture, "drag-end", G_CALLBACK (gtk_text_view_drag_gesture_end), widget); gtk_widget_add_controller (widget, GTK_EVENT_CONTROLLER (priv->drag_gesture)); controller = gtk_event_controller_motion_new (); g_signal_connect (controller, "motion", G_CALLBACK (gtk_text_view_motion), widget); gtk_widget_add_controller (widget, controller); priv->key_controller = gtk_event_controller_key_new (); g_signal_connect (priv->key_controller, "key-pressed", G_CALLBACK (gtk_text_view_key_controller_key_pressed), widget); g_signal_connect (priv->key_controller, "im-update", G_CALLBACK (gtk_text_view_key_controller_im_update), widget); gtk_event_controller_key_set_im_context (GTK_EVENT_CONTROLLER_KEY (priv->key_controller), priv->im_context); gtk_widget_add_controller (widget, priv->key_controller); controller = gtk_event_controller_focus_new (); g_signal_connect_swapped (controller, "enter", G_CALLBACK (gtk_text_view_focus_in), widget); g_signal_connect_swapped (controller, "leave", G_CALLBACK (gtk_text_view_focus_out), widget); gtk_widget_add_controller (widget, controller); priv->selection_node = gtk_css_node_new (); gtk_css_node_set_name (priv->selection_node, g_quark_from_static_string ("selection")); gtk_css_node_set_parent (priv->selection_node, priv->text_window->css_node); gtk_css_node_set_state (priv->selection_node, gtk_css_node_get_state (priv->text_window->css_node) & ~GTK_STATE_FLAG_DROP_ACTIVE); gtk_css_node_set_visible (priv->selection_node, FALSE); g_object_unref (priv->selection_node); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "text.can-redo", FALSE); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "text.can-undo", FALSE); gtk_accessible_update_property (GTK_ACCESSIBLE (widget), GTK_ACCESSIBLE_PROPERTY_MULTI_LINE, TRUE, -1); } GtkCssNode * gtk_text_view_get_text_node (GtkTextView *text_view) { return text_view->priv->text_window->css_node; } GtkCssNode * gtk_text_view_get_selection_node (GtkTextView *text_view) { return text_view->priv->selection_node; } static void _gtk_text_view_ensure_magnifier (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (priv->magnifier_popover) return; priv->magnifier = _gtk_magnifier_new (GTK_WIDGET (text_view)); _gtk_magnifier_set_magnification (GTK_MAGNIFIER (priv->magnifier), 2.0); priv->magnifier_popover = gtk_popover_new (); gtk_popover_set_position (GTK_POPOVER (priv->magnifier_popover), GTK_POS_TOP); gtk_widget_set_parent (priv->magnifier_popover, GTK_WIDGET (text_view)); gtk_widget_add_css_class (priv->magnifier_popover, "magnifier"); gtk_popover_set_autohide (GTK_POPOVER (priv->magnifier_popover), FALSE); gtk_popover_set_child (GTK_POPOVER (priv->magnifier_popover), priv->magnifier); gtk_widget_show (priv->magnifier); } /** * gtk_text_view_new: * * Creates a new #GtkTextView. If you don’t call gtk_text_view_set_buffer() * before using the text view, an empty default buffer will be created * for you. Get the buffer with gtk_text_view_get_buffer(). If you want * to specify your own buffer, consider gtk_text_view_new_with_buffer(). * * Returns: a new #GtkTextView **/ GtkWidget* gtk_text_view_new (void) { return g_object_new (GTK_TYPE_TEXT_VIEW, NULL); } /** * gtk_text_view_new_with_buffer: * @buffer: a #GtkTextBuffer * * Creates a new #GtkTextView widget displaying the buffer * @buffer. One buffer can be shared among many widgets. * @buffer may be %NULL to create a default buffer, in which case * this function is equivalent to gtk_text_view_new(). The * text view adds its own reference count to the buffer; it does not * take over an existing reference. * * Returns: a new #GtkTextView. **/ GtkWidget* gtk_text_view_new_with_buffer (GtkTextBuffer *buffer) { GtkTextView *text_view; text_view = (GtkTextView*)gtk_text_view_new (); gtk_text_view_set_buffer (text_view, buffer); return GTK_WIDGET (text_view); } /** * gtk_text_view_set_buffer: * @text_view: a #GtkTextView * @buffer: (allow-none): a #GtkTextBuffer * * Sets @buffer as the buffer being displayed by @text_view. The previous * buffer displayed by the text view is unreferenced, and a reference is * added to @buffer. If you owned a reference to @buffer before passing it * to this function, you must remove that reference yourself; #GtkTextView * will not “adopt” it. **/ void gtk_text_view_set_buffer (GtkTextView *text_view, GtkTextBuffer *buffer) { GtkTextViewPrivate *priv; GtkTextBuffer *old_buffer; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (buffer == NULL || GTK_IS_TEXT_BUFFER (buffer)); priv = text_view->priv; if (priv->buffer == buffer) return; old_buffer = priv->buffer; if (old_buffer != NULL) { while (priv->anchored_children.length) { AnchoredChild *ac = g_queue_peek_head (&priv->anchored_children); gtk_text_view_remove (text_view, ac->widget); /* ac is now invalid! */ } g_signal_handlers_disconnect_by_func (priv->buffer, gtk_text_view_mark_set_handler, text_view); g_signal_handlers_disconnect_by_func (priv->buffer, gtk_text_view_paste_done_handler, text_view); g_signal_handlers_disconnect_by_func (priv->buffer, gtk_text_view_buffer_changed_handler, text_view); g_signal_handlers_disconnect_by_func (priv->buffer, gtk_text_view_buffer_notify_redo, text_view); g_signal_handlers_disconnect_by_func (priv->buffer, gtk_text_view_buffer_notify_undo, text_view); if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { GdkClipboard *clipboard = gtk_widget_get_primary_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_remove_selection_clipboard (priv->buffer, clipboard); } if (priv->layout) gtk_text_layout_set_buffer (priv->layout, NULL); priv->dnd_mark = NULL; priv->first_para_mark = NULL; cancel_pending_scroll (text_view); } priv->buffer = buffer; if (priv->layout) gtk_text_layout_set_buffer (priv->layout, buffer); if (buffer != NULL) { GtkTextIter start; gboolean can_undo = FALSE; gboolean can_redo = FALSE; g_object_ref (buffer); gtk_text_buffer_get_iter_at_offset (priv->buffer, &start, 0); priv->dnd_mark = gtk_text_buffer_create_mark (priv->buffer, "gtk_drag_target", &start, FALSE); priv->first_para_mark = gtk_text_buffer_create_mark (priv->buffer, NULL, &start, TRUE); priv->first_para_pixels = 0; g_signal_connect (priv->buffer, "mark-set", G_CALLBACK (gtk_text_view_mark_set_handler), text_view); g_signal_connect (priv->buffer, "paste-done", G_CALLBACK (gtk_text_view_paste_done_handler), text_view); g_signal_connect (priv->buffer, "changed", G_CALLBACK (gtk_text_view_buffer_changed_handler), text_view); g_signal_connect (priv->buffer, "notify", G_CALLBACK (gtk_text_view_buffer_notify_undo), text_view); g_signal_connect (priv->buffer, "notify", G_CALLBACK (gtk_text_view_buffer_notify_redo), text_view); can_undo = gtk_text_buffer_get_can_undo (buffer); can_redo = gtk_text_buffer_get_can_redo (buffer); if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { GdkClipboard *clipboard = gtk_widget_get_primary_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_add_selection_clipboard (priv->buffer, clipboard); } gtk_text_view_update_handles (text_view); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "text.undo", can_undo); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "text.redo", can_redo); } if (old_buffer) g_object_unref (old_buffer); g_object_notify (G_OBJECT (text_view), "buffer"); if (gtk_widget_get_visible (GTK_WIDGET (text_view))) gtk_widget_queue_draw (GTK_WIDGET (text_view)); DV(g_print ("Invalidating due to set_buffer\n")); gtk_text_view_invalidate (text_view); } static GtkTextBuffer* gtk_text_view_create_buffer (GtkTextView *text_view) { return gtk_text_buffer_new (NULL); } /** * gtk_text_view_get_buffer: * @text_view: a #GtkTextView * * Returns the #GtkTextBuffer being displayed by this text view. * The reference count on the buffer is not incremented; the caller * of this function won’t own a new reference. * * Returns: (transfer none): a #GtkTextBuffer **/ GtkTextBuffer* gtk_text_view_get_buffer (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); return get_buffer (text_view); } /** * gtk_text_view_get_cursor_locations: * @text_view: a #GtkTextView * @iter: (allow-none): a #GtkTextIter * @strong: (out) (allow-none): location to store the strong * cursor position (may be %NULL) * @weak: (out) (allow-none): location to store the weak * cursor position (may be %NULL) * * Given an @iter within a text layout, determine the positions of the * strong and weak cursors if the insertion point is at that * iterator. The position of each cursor is stored as a zero-width * rectangle. The strong cursor location is the location where * characters of the directionality equal to the base direction of the * paragraph are inserted. The weak cursor location is the location * where characters of the directionality opposite to the base * direction of the paragraph are inserted. * * If @iter is %NULL, the actual cursor position is used. * * Note that if @iter happens to be the actual cursor position, and * there is currently an IM preedit sequence being entered, the * returned locations will be adjusted to account for the preedit * cursor’s offset within the preedit sequence. * * The rectangle position is in buffer coordinates; use * gtk_text_view_buffer_to_window_coords() to convert these * coordinates to coordinates for one of the windows in the text view. **/ void gtk_text_view_get_cursor_locations (GtkTextView *text_view, const GtkTextIter *iter, GdkRectangle *strong, GdkRectangle *weak) { GtkTextIter insert; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (iter == NULL || gtk_text_iter_get_buffer (iter) == get_buffer (text_view)); gtk_text_view_ensure_layout (text_view); if (iter) insert = *iter; else gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); gtk_text_layout_get_cursor_locations (text_view->priv->layout, &insert, strong, weak); } /** * gtk_text_view_get_iter_at_location: * @text_view: a #GtkTextView * @iter: (out): a #GtkTextIter * @x: x position, in buffer coordinates * @y: y position, in buffer coordinates * * Retrieves the iterator at buffer coordinates @x and @y. Buffer * coordinates are coordinates for the entire buffer, not just the * currently-displayed portion. If you have coordinates from an * event, you have to convert those to buffer coordinates with * gtk_text_view_window_to_buffer_coords(). * * Returns: %TRUE if the position is over text */ gboolean gtk_text_view_get_iter_at_location (GtkTextView *text_view, GtkTextIter *iter, int x, int y) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_get_iter_at_pixel (text_view->priv->layout, iter, x, y); } /** * gtk_text_view_get_iter_at_position: * @text_view: a #GtkTextView * @iter: (out): a #GtkTextIter * @trailing: (out) (allow-none): if non-%NULL, location to store an integer indicating where * in the grapheme the user clicked. It will either be * zero, or the number of characters in the grapheme. * 0 represents the trailing edge of the grapheme. * @x: x position, in buffer coordinates * @y: y position, in buffer coordinates * * Retrieves the iterator pointing to the character at buffer * coordinates @x and @y. Buffer coordinates are coordinates for * the entire buffer, not just the currently-displayed portion. * If you have coordinates from an event, you have to convert * those to buffer coordinates with * gtk_text_view_window_to_buffer_coords(). * * Note that this is different from gtk_text_view_get_iter_at_location(), * which returns cursor locations, i.e. positions between * characters. * * Returns: %TRUE if the position is over text **/ gboolean gtk_text_view_get_iter_at_position (GtkTextView *text_view, GtkTextIter *iter, int *trailing, int x, int y) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_get_iter_at_position (text_view->priv->layout, iter, trailing, x, y); } /** * gtk_text_view_get_iter_location: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * @location: (out): bounds of the character at @iter * * Gets a rectangle which roughly contains the character at @iter. * The rectangle position is in buffer coordinates; use * gtk_text_view_buffer_to_window_coords() to convert these * coordinates to coordinates for one of the windows in the text view. **/ void gtk_text_view_get_iter_location (GtkTextView *text_view, const GtkTextIter *iter, GdkRectangle *location) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (gtk_text_iter_get_buffer (iter) == get_buffer (text_view)); gtk_text_view_ensure_layout (text_view); gtk_text_layout_get_iter_location (text_view->priv->layout, iter, location); } /** * gtk_text_view_get_line_yrange: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * @y: (out): return location for a y coordinate * @height: (out): return location for a height * * Gets the y coordinate of the top of the line containing @iter, * and the height of the line. The coordinate is a buffer coordinate; * convert to window coordinates with gtk_text_view_buffer_to_window_coords(). **/ void gtk_text_view_get_line_yrange (GtkTextView *text_view, const GtkTextIter *iter, int *y, int *height) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (gtk_text_iter_get_buffer (iter) == get_buffer (text_view)); gtk_text_view_ensure_layout (text_view); gtk_text_layout_get_line_yrange (text_view->priv->layout, iter, y, height); } /** * gtk_text_view_get_line_at_y: * @text_view: a #GtkTextView * @target_iter: (out): a #GtkTextIter * @y: a y coordinate * @line_top: (out): return location for top coordinate of the line * * Gets the #GtkTextIter at the start of the line containing * the coordinate @y. @y is in buffer coordinates, convert from * window coordinates with gtk_text_view_window_to_buffer_coords(). * If non-%NULL, @line_top will be filled with the coordinate of the top * edge of the line. **/ void gtk_text_view_get_line_at_y (GtkTextView *text_view, GtkTextIter *target_iter, int y, int *line_top) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); gtk_text_view_ensure_layout (text_view); gtk_text_layout_get_line_at_y (text_view->priv->layout, target_iter, y, line_top); } /* Same as gtk_text_view_scroll_to_iter but deal with * (top_margin / top_padding) and (bottom_margin / bottom_padding). * When with_border == TRUE and you scroll on the edges, * all borders are shown for the corresponding edge. * When with_border == FALSE, only left margin and right_margin * can be seen because they can be can be overwritten by tags. */ static gboolean _gtk_text_view_scroll_to_iter (GtkTextView *text_view, GtkTextIter *iter, double within_margin, gboolean use_align, double xalign, double yalign, gboolean with_border) { GtkTextViewPrivate *priv = text_view->priv; GtkWidget *widget; GdkRectangle cursor; int cursor_bottom; int cursor_right; GdkRectangle screen; GdkRectangle screen_dest; int screen_inner_left; int screen_inner_right; int screen_inner_top; int screen_inner_bottom; int border_xoffset = 0; int border_yoffset = 0; int within_margin_xoffset; int within_margin_yoffset; int buffer_bottom; int buffer_right; gboolean retval = FALSE; /* FIXME why don't we do the validate-at-scroll-destination thing * from flush_scroll in this function? I think it wasn't done before * because changed_handler was screwed up, but I could be wrong. */ g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); g_return_val_if_fail (within_margin >= 0.0 && within_margin < 0.5, FALSE); g_return_val_if_fail (xalign >= 0.0 && xalign <= 1.0, FALSE); g_return_val_if_fail (yalign >= 0.0 && yalign <= 1.0, FALSE); widget = GTK_WIDGET (text_view); DV(g_print(G_STRLOC"\n")); gtk_text_layout_get_iter_location (priv->layout, iter, &cursor); DV (g_print (" target cursor %d,%d %d x %d\n", cursor.x, cursor.y, cursor.width, cursor.height)); /* In each direction, *_border are the addition of *_padding and *_margin * * Vadjustment value: * (-priv->top_margin) [top padding][top margin] (0) [text][bottom margin][bottom padding] * * Hadjustment value: * (-priv->left_padding) [left padding] (0) [left margin][text][right margin][right padding] * * Buffer coordinates: * on x: (0) [left margin][text][right margin] * on y: (0) [text] * * left margin and right margin are part of the x buffer coordinate * because they are part of the pango layout so that they can be * overwritten by tags. * * Canvas coordinates: * (the canvas is the virtual window where the content of the buffer is drawn ) * * on x: (-priv->left_padding) [left padding] (0) [left margin][text][right margin][right padding] * on y: (-priv->top_margin) [top margin][top padding] (0) [text][bottom margin][bottom padding] * * (priv->xoffset, priv->yoffset) is the origin of the view (visible part of the canvas) * in canvas coordinates. * As you can see, canvas coordinates and buffer coordinates are compatible but the canvas * can be larger than the buffer depending of the border size. */ cursor_bottom = cursor.y + cursor.height; cursor_right = cursor.x + cursor.width; /* Current position of the view in canvas coordinates */ screen.x = priv->xoffset; screen.y = priv->yoffset; screen.width = SCREEN_WIDTH (widget); screen.height = SCREEN_HEIGHT (widget); within_margin_xoffset = screen.width * within_margin; within_margin_yoffset = screen.height * within_margin; screen_inner_left = screen.x + within_margin_xoffset; screen_inner_top = screen.y + within_margin_yoffset; screen_inner_right = screen.x + screen.width - within_margin_xoffset; screen_inner_bottom = screen.y + screen.height - within_margin_yoffset; buffer_bottom = priv->height - priv->bottom_margin; buffer_right = priv->width - priv->right_margin - priv->left_padding - 1; screen_dest.x = screen.x; screen_dest.y = screen.y; screen_dest.width = screen.width - within_margin_xoffset * 2; screen_dest.height = screen.height - within_margin_yoffset * 2; /* Minimum authorised size check */ if (screen_dest.width < 1) screen_dest.width = 1; if (screen_dest.height < 1) screen_dest.height = 1; /* The alignment affects the point in the target character that we * choose to align. If we're doing right/bottom alignment, we align * the right/bottom edge of the character the mark is at; if we're * doing left/top we align the left/top edge of the character; if * we're doing center alignment we align the center of the * character. * * The different cases handle on each direction: * 1. cursor outside of the inner area define by within_margin * 2. if use_align == TRUE, alignment with xalign and yalign * 3. scrolling on the edges dependent of with_border */ /* Vertical scroll */ if (use_align) { int cursor_y_alignment_offset; cursor_y_alignment_offset = (cursor.height * yalign) - (screen_dest.height * yalign); screen_dest.y = cursor.y + cursor_y_alignment_offset - within_margin_yoffset; } else { /* move minimum to get onscreen, showing the * top_margin or bottom_margin when necessary */ if (cursor.y < screen_inner_top) { if (cursor.y == 0) border_yoffset = (with_border) ? priv->top_padding : 0; screen_dest.y = cursor.y - MAX (within_margin_yoffset, border_yoffset); } else if (cursor_bottom > screen_inner_bottom) { if (cursor_bottom == buffer_bottom - priv->top_margin) border_yoffset = (with_border) ? priv->bottom_padding : 0; screen_dest.y = cursor_bottom - screen_dest.height + MAX (within_margin_yoffset, border_yoffset); } } if (screen_dest.y != screen.y) { gtk_adjustment_animate_to_value (priv->vadjustment, screen_dest.y + priv->top_margin); DV (g_print (" vert increment %d\n", screen_dest.y - screen.y)); } /* Horizontal scroll */ if (use_align) { int cursor_x_alignment_offset; cursor_x_alignment_offset = (cursor.width * xalign) - (screen_dest.width * xalign); screen_dest.x = cursor.x + cursor_x_alignment_offset - within_margin_xoffset; } else { /* move minimum to get onscreen, showing the * left_margin or right_margin when necessary */ if (cursor.x < screen_inner_left) { if (cursor.x == priv->left_margin) border_xoffset = (with_border) ? priv->left_padding : 0; screen_dest.x = cursor.x - MAX (within_margin_xoffset, border_xoffset); } else if (cursor_right >= screen_inner_right - 1) { if (cursor.x >= buffer_right - priv->right_padding) border_xoffset = (with_border) ? priv->right_padding : 0; screen_dest.x = cursor_right - screen_dest.width + MAX (within_margin_xoffset, border_xoffset) + 1; } } if (screen_dest.x != screen.x) { gtk_adjustment_animate_to_value (priv->hadjustment, screen_dest.x + priv->left_padding); DV (g_print (" horiz increment %d\n", screen_dest.x - screen.x)); } retval = (screen.y != screen_dest.y) || (screen.x != screen_dest.x); DV(g_print (">%s ("G_STRLOC")\n", retval ? "Actually scrolled" : "Didn't end up scrolling")); return retval; } /** * gtk_text_view_scroll_to_iter: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * @within_margin: margin as a [0.0,0.5) fraction of screen size * @use_align: whether to use alignment arguments (if %FALSE, * just get the mark onscreen) * @xalign: horizontal alignment of mark within visible area * @yalign: vertical alignment of mark within visible area * * Scrolls @text_view so that @iter is on the screen in the position * indicated by @xalign and @yalign. An alignment of 0.0 indicates * left or top, 1.0 indicates right or bottom, 0.5 means center. * If @use_align is %FALSE, the text scrolls the minimal distance to * get the mark onscreen, possibly not scrolling at all. The effective * screen for purposes of this function is reduced by a margin of size * @within_margin. * * Note that this function uses the currently-computed height of the * lines in the text buffer. Line heights are computed in an idle * handler; so this function may not have the desired effect if it’s * called before the height computations. To avoid oddness, consider * using gtk_text_view_scroll_to_mark() which saves a point to be * scrolled to after line validation. * * Returns: %TRUE if scrolling occurred **/ gboolean gtk_text_view_scroll_to_iter (GtkTextView *text_view, GtkTextIter *iter, double within_margin, gboolean use_align, double xalign, double yalign) { return _gtk_text_view_scroll_to_iter (text_view, iter, within_margin, use_align, xalign, yalign, FALSE); } static void free_pending_scroll (GtkTextPendingScroll *scroll) { if (!gtk_text_mark_get_deleted (scroll->mark)) gtk_text_buffer_delete_mark (gtk_text_mark_get_buffer (scroll->mark), scroll->mark); g_object_unref (scroll->mark); g_slice_free (GtkTextPendingScroll, scroll); } static void cancel_pending_scroll (GtkTextView *text_view) { if (text_view->priv->pending_scroll) { free_pending_scroll (text_view->priv->pending_scroll); text_view->priv->pending_scroll = NULL; } } static void gtk_text_view_queue_scroll (GtkTextView *text_view, GtkTextMark *mark, double within_margin, gboolean use_align, double xalign, double yalign) { GtkTextIter iter; GtkTextPendingScroll *scroll; DV(g_print(G_STRLOC"\n")); scroll = g_slice_new (GtkTextPendingScroll); scroll->within_margin = within_margin; scroll->use_align = use_align; scroll->xalign = xalign; scroll->yalign = yalign; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, mark); scroll->mark = gtk_text_buffer_create_mark (get_buffer (text_view), NULL, &iter, gtk_text_mark_get_left_gravity (mark)); g_object_ref (scroll->mark); cancel_pending_scroll (text_view); text_view->priv->pending_scroll = scroll; } static gboolean gtk_text_view_flush_scroll (GtkTextView *text_view) { int height; GtkTextIter iter; GtkTextPendingScroll *scroll; gboolean retval; GtkWidget *widget; widget = GTK_WIDGET (text_view); DV(g_print(G_STRLOC"\n")); if (text_view->priv->pending_scroll == NULL) { DV (g_print ("in flush scroll, no pending scroll\n")); return FALSE; } scroll = text_view->priv->pending_scroll; /* avoid recursion */ text_view->priv->pending_scroll = NULL; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, scroll->mark); /* Validate area around the scroll destination, so the adjustment * can meaningfully point into that area. We must validate * enough area to be sure that after we scroll, everything onscreen * is valid; otherwise, validation will maintain the first para * in one place, but may push the target iter off the bottom of * the screen. */ DV(g_print (">Validating scroll destination ("G_STRLOC")\n")); height = gtk_widget_get_height (widget); gtk_text_layout_validate_yrange (text_view->priv->layout, &iter, - (height * 2), height * 2); DV(g_print (">Done validating scroll destination ("G_STRLOC")\n")); /* Ensure we have updated width/height */ gtk_text_view_update_adjustments (text_view); retval = _gtk_text_view_scroll_to_iter (text_view, &iter, scroll->within_margin, scroll->use_align, scroll->xalign, scroll->yalign, TRUE); gtk_text_view_update_handles (text_view); free_pending_scroll (scroll); return retval; } static void gtk_text_view_update_adjustments (GtkTextView *text_view) { GtkTextViewPrivate *priv; int width = 0, height = 0; DV(g_print(">Updating adjustments ("G_STRLOC")\n")); priv = text_view->priv; if (priv->layout) gtk_text_layout_get_size (priv->layout, &width, &height); /* Make room for the cursor after the last character in the widest line */ width += SPACE_FOR_CURSOR; height += priv->top_margin + priv->bottom_margin; if (priv->width != width || priv->height != height) { priv->width = width; priv->height = height; gtk_text_view_set_hadjustment_values (text_view); gtk_text_view_set_vadjustment_values (text_view); } } static void gtk_text_view_update_layout_width (GtkTextView *text_view) { DV(g_print(">Updating layout width ("G_STRLOC")\n")); gtk_text_view_ensure_layout (text_view); gtk_text_layout_set_screen_width (text_view->priv->layout, MAX (1, SCREEN_WIDTH (text_view) - SPACE_FOR_CURSOR)); } static void gtk_text_view_update_im_spot_location (GtkTextView *text_view) { GdkRectangle area; if (text_view->priv->layout == NULL) return; gtk_text_view_get_cursor_locations (text_view, NULL, &area, NULL); area.x -= text_view->priv->xoffset; area.y -= text_view->priv->yoffset; /* Width returned by Pango indicates direction of cursor, * by its sign more than the size of cursor. */ area.width = 0; gtk_im_context_set_cursor_location (text_view->priv->im_context, &area); } static gboolean do_update_im_spot_location (gpointer text_view) { GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW (text_view)->priv; priv->im_spot_idle = 0; gtk_text_view_update_im_spot_location (text_view); return FALSE; } static void queue_update_im_spot_location (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = text_view->priv; /* Use priority a little higher than GTK_TEXT_VIEW_PRIORITY_VALIDATE, * so we don't wait until the entire buffer has been validated. */ if (!priv->im_spot_idle) { priv->im_spot_idle = g_idle_add_full (GTK_TEXT_VIEW_PRIORITY_VALIDATE - 1, do_update_im_spot_location, text_view, NULL); g_source_set_name_by_id (priv->im_spot_idle, "[gtk] do_update_im_spot_location"); } } static void flush_update_im_spot_location (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = text_view->priv; if (priv->im_spot_idle) { g_source_remove (priv->im_spot_idle); priv->im_spot_idle = 0; gtk_text_view_update_im_spot_location (text_view); } } /** * gtk_text_view_scroll_to_mark: * @text_view: a #GtkTextView * @mark: a #GtkTextMark * @within_margin: margin as a [0.0,0.5) fraction of screen size * @use_align: whether to use alignment arguments (if %FALSE, just * get the mark onscreen) * @xalign: horizontal alignment of mark within visible area * @yalign: vertical alignment of mark within visible area * * Scrolls @text_view so that @mark is on the screen in the position * indicated by @xalign and @yalign. An alignment of 0.0 indicates * left or top, 1.0 indicates right or bottom, 0.5 means center. * If @use_align is %FALSE, the text scrolls the minimal distance to * get the mark onscreen, possibly not scrolling at all. The effective * screen for purposes of this function is reduced by a margin of size * @within_margin. **/ void gtk_text_view_scroll_to_mark (GtkTextView *text_view, GtkTextMark *mark, double within_margin, gboolean use_align, double xalign, double yalign) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_TEXT_MARK (mark)); g_return_if_fail (within_margin >= 0.0 && within_margin < 0.5); g_return_if_fail (xalign >= 0.0 && xalign <= 1.0); g_return_if_fail (yalign >= 0.0 && yalign <= 1.0); /* We need to verify that the buffer contains the mark, otherwise this * can lead to data structure corruption later on. */ g_return_if_fail (get_buffer (text_view) == gtk_text_mark_get_buffer (mark)); gtk_text_view_queue_scroll (text_view, mark, within_margin, use_align, xalign, yalign); /* If no validation is pending, we need to go ahead and force an * immediate scroll. */ if (text_view->priv->layout && gtk_text_layout_is_valid (text_view->priv->layout)) gtk_text_view_flush_scroll (text_view); } /** * gtk_text_view_scroll_mark_onscreen: * @text_view: a #GtkTextView * @mark: a mark in the buffer for @text_view * * Scrolls @text_view the minimum distance such that @mark is contained * within the visible area of the widget. **/ void gtk_text_view_scroll_mark_onscreen (GtkTextView *text_view, GtkTextMark *mark) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_TEXT_MARK (mark)); /* We need to verify that the buffer contains the mark, otherwise this * can lead to data structure corruption later on. */ g_return_if_fail (get_buffer (text_view) == gtk_text_mark_get_buffer (mark)); gtk_text_view_scroll_to_mark (text_view, mark, 0.0, FALSE, 0.0, 0.0); } static gboolean clamp_iter_onscreen (GtkTextView *text_view, GtkTextIter *iter) { GdkRectangle visible_rect; gtk_text_view_get_visible_rect (text_view, &visible_rect); return gtk_text_layout_clamp_iter_to_vrange (text_view->priv->layout, iter, visible_rect.y, visible_rect.y + visible_rect.height); } /** * gtk_text_view_move_mark_onscreen: * @text_view: a #GtkTextView * @mark: a #GtkTextMark * * Moves a mark within the buffer so that it's * located within the currently-visible text area. * * Returns: %TRUE if the mark moved (wasn’t already onscreen) **/ gboolean gtk_text_view_move_mark_onscreen (GtkTextView *text_view, GtkTextMark *mark) { GtkTextIter iter; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (mark != NULL, FALSE); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, mark); if (clamp_iter_onscreen (text_view, &iter)) { gtk_text_buffer_move_mark (get_buffer (text_view), mark, &iter); return TRUE; } else return FALSE; } /** * gtk_text_view_get_visible_rect: * @text_view: a #GtkTextView * @visible_rect: (out): rectangle to fill * * Fills @visible_rect with the currently-visible * region of the buffer, in buffer coordinates. Convert to window coordinates * with gtk_text_view_buffer_to_window_coords(). **/ void gtk_text_view_get_visible_rect (GtkTextView *text_view, GdkRectangle *visible_rect) { GtkWidget *widget; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); widget = GTK_WIDGET (text_view); if (visible_rect) { visible_rect->x = text_view->priv->xoffset; visible_rect->y = text_view->priv->yoffset; visible_rect->width = SCREEN_WIDTH (widget); visible_rect->height = SCREEN_HEIGHT (widget); DV(g_print(" visible rect: %d,%d %d x %d\n", visible_rect->x, visible_rect->y, visible_rect->width, visible_rect->height)); } } /** * gtk_text_view_set_wrap_mode: * @text_view: a #GtkTextView * @wrap_mode: a #GtkWrapMode * * Sets the line wrapping for the view. **/ void gtk_text_view_set_wrap_mode (GtkTextView *text_view, GtkWrapMode wrap_mode) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->wrap_mode != wrap_mode) { priv->wrap_mode = wrap_mode; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->wrap_mode = wrap_mode; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "wrap-mode"); } } /** * gtk_text_view_get_wrap_mode: * @text_view: a #GtkTextView * * Gets the line wrapping for the view. * * Returns: the line wrap setting **/ GtkWrapMode gtk_text_view_get_wrap_mode (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), GTK_WRAP_NONE); return text_view->priv->wrap_mode; } /** * gtk_text_view_set_editable: * @text_view: a #GtkTextView * @setting: whether it’s editable * * Sets the default editability of the #GtkTextView. You can override * this default setting with tags in the buffer, using the “editable” * attribute of tags. **/ void gtk_text_view_set_editable (GtkTextView *text_view, gboolean setting) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; setting = setting != FALSE; if (priv->editable != setting) { if (!setting) { gtk_text_view_reset_im_context (text_view); if (gtk_widget_has_focus (GTK_WIDGET (text_view))) gtk_im_context_focus_out (priv->im_context); } priv->editable = setting; if (setting && gtk_widget_has_focus (GTK_WIDGET (text_view))) gtk_im_context_focus_in (priv->im_context); gtk_event_controller_key_set_im_context (GTK_EVENT_CONTROLLER_KEY (priv->key_controller), setting ? priv->im_context : NULL); if (priv->layout && priv->layout->default_style) { gtk_text_layout_set_overwrite_mode (priv->layout, priv->overwrite_mode && priv->editable); priv->layout->default_style->editable = priv->editable; gtk_text_layout_default_style_changed (priv->layout); } gtk_accessible_update_property (GTK_ACCESSIBLE (text_view), GTK_ACCESSIBLE_PROPERTY_READ_ONLY, !setting, -1); gtk_text_view_update_emoji_action (text_view); g_object_notify (G_OBJECT (text_view), "editable"); } } /** * gtk_text_view_get_editable: * @text_view: a #GtkTextView * * Returns the default editability of the #GtkTextView. Tags in the * buffer may override this setting for some ranges of text. * * Returns: whether text is editable by default **/ gboolean gtk_text_view_get_editable (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return text_view->priv->editable; } /** * gtk_text_view_set_pixels_above_lines: * @text_view: a #GtkTextView * @pixels_above_lines: pixels above paragraphs * * Sets the default number of blank pixels above paragraphs in @text_view. * Tags in the buffer for @text_view may override the defaults. **/ void gtk_text_view_set_pixels_above_lines (GtkTextView *text_view, int pixels_above_lines) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->pixels_above_lines != pixels_above_lines) { priv->pixels_above_lines = pixels_above_lines; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->pixels_above_lines = pixels_above_lines; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "pixels-above-lines"); } } /** * gtk_text_view_get_pixels_above_lines: * @text_view: a #GtkTextView * * Gets the default number of pixels to put above paragraphs. * Adding this function with gtk_text_view_get_pixels_below_lines() * is equal to the line space between each paragraph. * * Returns: default number of pixels above paragraphs **/ int gtk_text_view_get_pixels_above_lines (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->pixels_above_lines; } /** * gtk_text_view_set_pixels_below_lines: * @text_view: a #GtkTextView * @pixels_below_lines: pixels below paragraphs * * Sets the default number of pixels of blank space * to put below paragraphs in @text_view. May be overridden * by tags applied to @text_view’s buffer. **/ void gtk_text_view_set_pixels_below_lines (GtkTextView *text_view, int pixels_below_lines) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->pixels_below_lines != pixels_below_lines) { priv->pixels_below_lines = pixels_below_lines; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->pixels_below_lines = pixels_below_lines; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "pixels-below-lines"); } } /** * gtk_text_view_get_pixels_below_lines: * @text_view: a #GtkTextView * * Gets the value set by gtk_text_view_set_pixels_below_lines(). * * The line space is the sum of the value returned by this function and the * value returned by gtk_text_view_get_pixels_above_lines(). * * Returns: default number of blank pixels below paragraphs **/ int gtk_text_view_get_pixels_below_lines (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->pixels_below_lines; } /** * gtk_text_view_set_pixels_inside_wrap: * @text_view: a #GtkTextView * @pixels_inside_wrap: default number of pixels between wrapped lines * * Sets the default number of pixels of blank space to leave between * display/wrapped lines within a paragraph. May be overridden by * tags in @text_view’s buffer. **/ void gtk_text_view_set_pixels_inside_wrap (GtkTextView *text_view, int pixels_inside_wrap) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->pixels_inside_wrap != pixels_inside_wrap) { priv->pixels_inside_wrap = pixels_inside_wrap; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->pixels_inside_wrap = pixels_inside_wrap; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "pixels-inside-wrap"); } } /** * gtk_text_view_get_pixels_inside_wrap: * @text_view: a #GtkTextView * * Gets the value set by gtk_text_view_set_pixels_inside_wrap(). * * Returns: default number of pixels of blank space between wrapped lines **/ int gtk_text_view_get_pixels_inside_wrap (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->pixels_inside_wrap; } /** * gtk_text_view_set_justification: * @text_view: a #GtkTextView * @justification: justification * * Sets the default justification of text in @text_view. * Tags in the view’s buffer may override the default. * **/ void gtk_text_view_set_justification (GtkTextView *text_view, GtkJustification justification) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->justify != justification) { priv->justify = justification; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->justification = justification; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "justification"); } } /** * gtk_text_view_get_justification: * @text_view: a #GtkTextView * * Gets the default justification of paragraphs in @text_view. * Tags in the buffer may override the default. * * Returns: default justification **/ GtkJustification gtk_text_view_get_justification (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), GTK_JUSTIFY_LEFT); return text_view->priv->justify; } /** * gtk_text_view_set_left_margin: * @text_view: a #GtkTextView * @left_margin: left margin in pixels * * Sets the default left margin for text in @text_view. * Tags in the buffer may override the default. * * Note that this function is confusingly named. * In CSS terms, the value set here is padding. */ void gtk_text_view_set_left_margin (GtkTextView *text_view, int left_margin) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (priv->left_margin != left_margin) { priv->left_margin = left_margin; priv->left_margin = left_margin + priv->left_padding; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->left_margin = left_margin; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "left-margin"); } } /** * gtk_text_view_get_left_margin: * @text_view: a #GtkTextView * * Gets the default left margin size of paragraphs in the @text_view. * Tags in the buffer may override the default. * * Returns: left margin in pixels */ int gtk_text_view_get_left_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->left_margin; } /** * gtk_text_view_set_right_margin: * @text_view: a #GtkTextView * @right_margin: right margin in pixels * * Sets the default right margin for text in the text view. * Tags in the buffer may override the default. * * Note that this function is confusingly named. * In CSS terms, the value set here is padding. */ void gtk_text_view_set_right_margin (GtkTextView *text_view, int right_margin) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (priv->right_margin != right_margin) { priv->right_margin = right_margin; priv->right_margin = right_margin + priv->right_padding; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->right_margin = right_margin; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "right-margin"); } } /** * gtk_text_view_get_right_margin: * @text_view: a #GtkTextView * * Gets the default right margin for text in @text_view. Tags * in the buffer may override the default. * * Returns: right margin in pixels */ int gtk_text_view_get_right_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->right_margin; } /** * gtk_text_view_set_top_margin: * @text_view: a #GtkTextView * @top_margin: top margin in pixels * * Sets the top margin for text in @text_view. * * Note that this function is confusingly named. * In CSS terms, the value set here is padding. */ void gtk_text_view_set_top_margin (GtkTextView *text_view, int top_margin) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (priv->top_margin != top_margin) { priv->yoffset += priv->top_margin - top_margin; priv->top_margin = top_margin; priv->top_margin = top_margin + priv->top_padding; if (priv->layout && priv->layout->default_style) gtk_text_layout_default_style_changed (priv->layout); gtk_text_view_invalidate (text_view); g_object_notify (G_OBJECT (text_view), "top-margin"); } } /** * gtk_text_view_get_top_margin: * @text_view: a #GtkTextView * * Gets the top margin for text in the @text_view. * * Returns: top margin in pixels **/ int gtk_text_view_get_top_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->top_margin; } /** * gtk_text_view_set_bottom_margin: * @text_view: a #GtkTextView * @bottom_margin: bottom margin in pixels * * Sets the bottom margin for text in @text_view. * * Note that this function is confusingly named. * In CSS terms, the value set here is padding. */ void gtk_text_view_set_bottom_margin (GtkTextView *text_view, int bottom_margin) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (priv->bottom_margin != bottom_margin) { priv->bottom_margin = bottom_margin; priv->bottom_margin = bottom_margin + priv->bottom_padding; if (priv->layout && priv->layout->default_style) gtk_text_layout_default_style_changed (priv->layout); g_object_notify (G_OBJECT (text_view), "bottom-margin"); } } /** * gtk_text_view_get_bottom_margin: * @text_view: a #GtkTextView * * Gets the bottom margin for text in the @text_view. * * Returns: bottom margin in pixels */ int gtk_text_view_get_bottom_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->bottom_margin; } /** * gtk_text_view_set_indent: * @text_view: a #GtkTextView * @indent: indentation in pixels * * Sets the default indentation for paragraphs in @text_view. * Tags in the buffer may override the default. **/ void gtk_text_view_set_indent (GtkTextView *text_view, int indent) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->indent != indent) { priv->indent = indent; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->indent = indent; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "indent"); } } /** * gtk_text_view_get_indent: * @text_view: a #GtkTextView * * Gets the default indentation of paragraphs in @text_view. * Tags in the view’s buffer may override the default. * The indentation may be negative. * * Returns: number of pixels of indentation **/ int gtk_text_view_get_indent (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->priv->indent; } /** * gtk_text_view_set_tabs: * @text_view: a #GtkTextView * @tabs: tabs as a #PangoTabArray * * Sets the default tab stops for paragraphs in @text_view. * Tags in the buffer may override the default. **/ void gtk_text_view_set_tabs (GtkTextView *text_view, PangoTabArray *tabs) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; if (priv->tabs) pango_tab_array_free (priv->tabs); priv->tabs = tabs ? pango_tab_array_copy (tabs) : NULL; if (priv->layout && priv->layout->default_style) { /* some unkosher futzing in internal struct details... */ if (priv->layout->default_style->tabs) pango_tab_array_free (priv->layout->default_style->tabs); priv->layout->default_style->tabs = priv->tabs ? pango_tab_array_copy (priv->tabs) : NULL; gtk_text_layout_default_style_changed (priv->layout); } g_object_notify (G_OBJECT (text_view), "tabs"); } /** * gtk_text_view_get_tabs: * @text_view: a #GtkTextView * * Gets the default tabs for @text_view. Tags in the buffer may * override the defaults. The returned array will be %NULL if * “standard” (8-space) tabs are used. Free the return value * with pango_tab_array_free(). * * Returns: (nullable) (transfer full): copy of default tab array, or %NULL if * “standard" tabs are used; must be freed with pango_tab_array_free(). **/ PangoTabArray* gtk_text_view_get_tabs (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); return text_view->priv->tabs ? pango_tab_array_copy (text_view->priv->tabs) : NULL; } static void gtk_text_view_toggle_cursor_visible (GtkTextView *text_view) { gtk_text_view_set_cursor_visible (text_view, !text_view->priv->cursor_visible); } /** * gtk_text_view_set_cursor_visible: * @text_view: a #GtkTextView * @setting: whether to show the insertion cursor * * Toggles whether the insertion point should be displayed. A buffer with * no editable text probably shouldn’t have a visible cursor, so you may * want to turn the cursor off. * * Note that this property may be overridden by the * #GtkSettings:gtk-keynav-use-caret settings. */ void gtk_text_view_set_cursor_visible (GtkTextView *text_view, gboolean setting) { GtkTextViewPrivate *priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); priv = text_view->priv; setting = (setting != FALSE); if (priv->cursor_visible != setting) { priv->cursor_visible = setting; if (gtk_widget_has_focus (GTK_WIDGET (text_view))) { if (priv->layout) { gtk_text_layout_set_cursor_visible (priv->layout, setting); gtk_text_view_check_cursor_blink (text_view); } } g_object_notify (G_OBJECT (text_view), "cursor-visible"); } } /** * gtk_text_view_get_cursor_visible: * @text_view: a #GtkTextView * * Find out whether the cursor should be displayed. * * Returns: whether the insertion mark is visible */ gboolean gtk_text_view_get_cursor_visible (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return text_view->priv->cursor_visible; } /** * gtk_text_view_reset_cursor_blink: * @text_view: a #GtkTextView * * Ensures that the cursor is shown (i.e. not in an 'off' blink * interval) and resets the time that it will stay blinking (or * visible, in case blinking is disabled). * * This function should be called in response to user input * (e.g. from derived classes that override the textview's * event handlers). */ void gtk_text_view_reset_cursor_blink (GtkTextView *text_view) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); gtk_text_view_reset_blink_time (text_view); gtk_text_view_pend_cursor_blink (text_view); } /** * gtk_text_view_place_cursor_onscreen: * @text_view: a #GtkTextView * * Moves the cursor to the currently visible region of the * buffer, if it isn’t there already. * * Returns: %TRUE if the cursor had to be moved. **/ gboolean gtk_text_view_place_cursor_onscreen (GtkTextView *text_view) { GtkTextIter insert; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); if (clamp_iter_onscreen (text_view, &insert)) { gtk_text_buffer_place_cursor (get_buffer (text_view), &insert); return TRUE; } else return FALSE; } static void gtk_text_view_remove_validate_idles (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (priv->first_validate_idle != 0) { DV (g_print ("Removing first validate idle: %s\n", G_STRLOC)); g_source_remove (priv->first_validate_idle); priv->first_validate_idle = 0; } if (priv->incremental_validate_idle != 0) { g_source_remove (priv->incremental_validate_idle); priv->incremental_validate_idle = 0; } } static void gtk_text_view_dispose (GObject *object) { GtkTextView *text_view = GTK_TEXT_VIEW (object); GtkTextViewPrivate *priv = text_view->priv; GtkWidget *child; child = g_object_get_data (object, "gtk-emoji-chooser"); if (child) { gtk_widget_unparent (child); g_object_set_data (object, "gtk-emoji-chooser", NULL); } gtk_text_view_remove_validate_idles (text_view); gtk_text_view_set_buffer (text_view, NULL); gtk_text_view_destroy_layout (text_view); if (text_view->priv->scroll_timeout) { g_source_remove (text_view->priv->scroll_timeout); text_view->priv->scroll_timeout = 0; } if (priv->im_spot_idle) { g_source_remove (priv->im_spot_idle); priv->im_spot_idle = 0; } if (priv->magnifier) _gtk_magnifier_set_inspected (GTK_MAGNIFIER (priv->magnifier), NULL); g_clear_pointer ((GtkWidget **) &priv->text_handles[TEXT_HANDLE_CURSOR], gtk_widget_unparent); g_clear_pointer ((GtkWidget **) &priv->text_handles[TEXT_HANDLE_SELECTION_BOUND], gtk_widget_unparent); g_clear_pointer (&priv->selection_bubble, gtk_widget_unparent); g_clear_pointer (&priv->magnifier_popover, gtk_widget_unparent); while ((child = gtk_widget_get_first_child (GTK_WIDGET (text_view)))) gtk_text_view_remove (text_view, child); G_OBJECT_CLASS (gtk_text_view_parent_class)->dispose (object); } static void gtk_text_view_finalize (GObject *object) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (object); priv = text_view->priv; gtk_text_view_destroy_layout (text_view); gtk_text_view_set_buffer (text_view, NULL); /* at this point, no "notify::buffer" handler should recreate the buffer. */ g_assert (priv->buffer == NULL); /* Ensure all children were removed */ g_assert (priv->anchored_children.length == 0); g_assert (priv->left_child == NULL); g_assert (priv->right_child == NULL); g_assert (priv->top_child == NULL); g_assert (priv->bottom_child == NULL); g_assert (priv->center_child == NULL); cancel_pending_scroll (text_view); if (priv->tabs) pango_tab_array_free (priv->tabs); if (priv->hadjustment) g_object_unref (priv->hadjustment); if (priv->vadjustment) g_object_unref (priv->vadjustment); text_window_free (priv->text_window); g_object_unref (priv->im_context); g_free (priv->im_module); g_clear_pointer (&priv->popup_menu, gtk_widget_unparent); g_clear_object (&priv->extra_menu); G_OBJECT_CLASS (gtk_text_view_parent_class)->finalize (object); } static void gtk_text_view_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (object); priv = text_view->priv; switch (prop_id) { case PROP_PIXELS_ABOVE_LINES: gtk_text_view_set_pixels_above_lines (text_view, g_value_get_int (value)); break; case PROP_PIXELS_BELOW_LINES: gtk_text_view_set_pixels_below_lines (text_view, g_value_get_int (value)); break; case PROP_PIXELS_INSIDE_WRAP: gtk_text_view_set_pixels_inside_wrap (text_view, g_value_get_int (value)); break; case PROP_EDITABLE: gtk_text_view_set_editable (text_view, g_value_get_boolean (value)); break; case PROP_WRAP_MODE: gtk_text_view_set_wrap_mode (text_view, g_value_get_enum (value)); break; case PROP_JUSTIFICATION: gtk_text_view_set_justification (text_view, g_value_get_enum (value)); break; case PROP_LEFT_MARGIN: gtk_text_view_set_left_margin (text_view, g_value_get_int (value)); break; case PROP_RIGHT_MARGIN: gtk_text_view_set_right_margin (text_view, g_value_get_int (value)); break; case PROP_TOP_MARGIN: gtk_text_view_set_top_margin (text_view, g_value_get_int (value)); break; case PROP_BOTTOM_MARGIN: gtk_text_view_set_bottom_margin (text_view, g_value_get_int (value)); break; case PROP_INDENT: gtk_text_view_set_indent (text_view, g_value_get_int (value)); break; case PROP_TABS: gtk_text_view_set_tabs (text_view, g_value_get_boxed (value)); break; case PROP_CURSOR_VISIBLE: gtk_text_view_set_cursor_visible (text_view, g_value_get_boolean (value)); break; case PROP_OVERWRITE: gtk_text_view_set_overwrite (text_view, g_value_get_boolean (value)); break; case PROP_BUFFER: gtk_text_view_set_buffer (text_view, GTK_TEXT_BUFFER (g_value_get_object (value))); break; case PROP_ACCEPTS_TAB: gtk_text_view_set_accepts_tab (text_view, g_value_get_boolean (value)); break; case PROP_IM_MODULE: g_free (priv->im_module); priv->im_module = g_value_dup_string (value); if (GTK_IS_IM_MULTICONTEXT (priv->im_context)) gtk_im_multicontext_set_context_id (GTK_IM_MULTICONTEXT (priv->im_context), priv->im_module); break; case PROP_HADJUSTMENT: gtk_text_view_set_hadjustment (text_view, g_value_get_object (value)); break; case PROP_VADJUSTMENT: gtk_text_view_set_vadjustment (text_view, g_value_get_object (value)); break; case PROP_HSCROLL_POLICY: if (priv->hscroll_policy != g_value_get_enum (value)) { priv->hscroll_policy = g_value_get_enum (value); gtk_widget_queue_resize (GTK_WIDGET (text_view)); g_object_notify_by_pspec (object, pspec); } break; case PROP_VSCROLL_POLICY: if (priv->vscroll_policy != g_value_get_enum (value)) { priv->vscroll_policy = g_value_get_enum (value); gtk_widget_queue_resize (GTK_WIDGET (text_view)); g_object_notify_by_pspec (object, pspec); } break; case PROP_INPUT_PURPOSE: gtk_text_view_set_input_purpose (text_view, g_value_get_enum (value)); break; case PROP_INPUT_HINTS: gtk_text_view_set_input_hints (text_view, g_value_get_flags (value)); break; case PROP_MONOSPACE: gtk_text_view_set_monospace (text_view, g_value_get_boolean (value)); break; case PROP_EXTRA_MENU: gtk_text_view_set_extra_menu (text_view, g_value_get_object (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_text_view_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (object); priv = text_view->priv; switch (prop_id) { case PROP_PIXELS_ABOVE_LINES: g_value_set_int (value, priv->pixels_above_lines); break; case PROP_PIXELS_BELOW_LINES: g_value_set_int (value, priv->pixels_below_lines); break; case PROP_PIXELS_INSIDE_WRAP: g_value_set_int (value, priv->pixels_inside_wrap); break; case PROP_EDITABLE: g_value_set_boolean (value, priv->editable); break; case PROP_WRAP_MODE: g_value_set_enum (value, priv->wrap_mode); break; case PROP_JUSTIFICATION: g_value_set_enum (value, priv->justify); break; case PROP_LEFT_MARGIN: g_value_set_int (value, priv->left_margin); break; case PROP_RIGHT_MARGIN: g_value_set_int (value, priv->right_margin); break; case PROP_TOP_MARGIN: g_value_set_int (value, priv->top_margin); break; case PROP_BOTTOM_MARGIN: g_value_set_int (value, priv->bottom_margin); break; case PROP_INDENT: g_value_set_int (value, priv->indent); break; case PROP_TABS: g_value_set_boxed (value, priv->tabs); break; case PROP_CURSOR_VISIBLE: g_value_set_boolean (value, priv->cursor_visible); break; case PROP_BUFFER: g_value_set_object (value, get_buffer (text_view)); break; case PROP_OVERWRITE: g_value_set_boolean (value, priv->overwrite_mode); break; case PROP_ACCEPTS_TAB: g_value_set_boolean (value, priv->accepts_tab); break; case PROP_IM_MODULE: g_value_set_string (value, priv->im_module); break; case PROP_HADJUSTMENT: g_value_set_object (value, priv->hadjustment); break; case PROP_VADJUSTMENT: g_value_set_object (value, priv->vadjustment); break; case PROP_HSCROLL_POLICY: g_value_set_enum (value, priv->hscroll_policy); break; case PROP_VSCROLL_POLICY: g_value_set_enum (value, priv->vscroll_policy); break; case PROP_INPUT_PURPOSE: g_value_set_enum (value, gtk_text_view_get_input_purpose (text_view)); break; case PROP_INPUT_HINTS: g_value_set_flags (value, gtk_text_view_get_input_hints (text_view)); break; case PROP_MONOSPACE: g_value_set_boolean (value, gtk_text_view_get_monospace (text_view)); break; case PROP_EXTRA_MENU: g_value_set_object (value, gtk_text_view_get_extra_menu (text_view)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_text_view_measure_borders (GtkTextView *text_view, GtkBorder *border) { GtkTextViewPrivate *priv = text_view->priv; int left = 0; int right = 0; int top = 0; int bottom = 0; if (priv->left_child) gtk_widget_measure (GTK_WIDGET (priv->left_child), GTK_ORIENTATION_HORIZONTAL, -1, &left, NULL, NULL, NULL); if (priv->right_child) gtk_widget_measure (GTK_WIDGET (priv->right_child), GTK_ORIENTATION_HORIZONTAL, -1, &right, NULL, NULL, NULL); if (priv->top_child) gtk_widget_measure (GTK_WIDGET (priv->top_child), GTK_ORIENTATION_VERTICAL, -1, &top, NULL, NULL, NULL); if (priv->bottom_child) gtk_widget_measure (GTK_WIDGET (priv->bottom_child), GTK_ORIENTATION_VERTICAL, -1, &bottom, NULL, NULL, NULL); border->left = left; border->right = right; border->top = top; border->bottom = bottom; } static void gtk_text_view_measure (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; const GList *list; GtkBorder borders; int min = 0; int nat = 0; int extra; gtk_text_view_measure_borders (text_view, &borders); if (priv->center_child) gtk_widget_measure (GTK_WIDGET (priv->center_child), orientation, for_size, &min, &nat, NULL, NULL); for (list = priv->anchored_children.head; list; list = list->next) { const AnchoredChild *child = list->data; int child_min = 0; int child_nat = 0; gtk_widget_measure (child->widget, orientation, for_size, &child_min, &child_nat, NULL, NULL); /* Invalidate layout lines if required */ if (child->anchor && priv->layout) gtk_text_child_anchor_queue_resize (child->anchor, priv->layout); min = MAX (min, child_min); nat = MAX (nat, child_nat); } if (orientation == GTK_ORIENTATION_HORIZONTAL) extra = borders.left + priv->left_margin + priv->right_margin + borders.right; else extra = borders.top + priv->height + borders.bottom; *minimum = min + extra; *natural = nat + extra; } static void gtk_text_view_compute_child_allocation (GtkTextView *text_view, const AnchoredChild *vc, GtkAllocation *allocation) { int buffer_y; GtkTextIter iter; GtkRequisition req; gtk_text_buffer_get_iter_at_child_anchor (get_buffer (text_view), &iter, vc->anchor); gtk_text_layout_get_line_yrange (text_view->priv->layout, &iter, &buffer_y, NULL); buffer_y += vc->from_top_of_line; allocation->x = vc->from_left_of_buffer - text_view->priv->xoffset; allocation->y = buffer_y - text_view->priv->yoffset; gtk_widget_get_preferred_size (vc->widget, &req, NULL); allocation->width = req.width; allocation->height = req.height; } static void gtk_text_view_update_child_allocation (GtkTextView *text_view, const AnchoredChild *vc) { GtkAllocation allocation; gtk_text_view_compute_child_allocation (text_view, vc, &allocation); gtk_widget_size_allocate (vc->widget, &allocation, -1); #if 0 g_print ("allocation for %p allocated to %d,%d yoffset = %d\n", vc->widget, vc->widget->allocation.x, vc->widget->allocation.y, text_view->priv->yoffset); #endif } static void gtk_anchored_child_allocated (GtkTextLayout *layout, GtkWidget *child, int x, int y, gpointer data) { AnchoredChild *vc = NULL; GtkTextView *text_view = data; /* x,y is the position of the child from the top of the line, and * from the left of the buffer. We have to translate that into text * window coordinates, then size_allocate the child. */ vc = g_object_get_qdata (G_OBJECT (child), quark_text_view_child); g_assert (vc != NULL); DV (g_print ("child allocated at %d,%d\n", x, y)); vc->from_left_of_buffer = x; vc->from_top_of_line = y; gtk_text_view_update_child_allocation (text_view, vc); } static void gtk_text_view_allocate_children (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; const GList *iter; DV(g_print(G_STRLOC"\n")); for (iter = priv->anchored_children.head; iter; iter = iter->next) { const AnchoredChild *child = iter->data; GtkTextIter child_loc; /* We need to force-validate the regions containing children. */ gtk_text_buffer_get_iter_at_child_anchor (get_buffer (text_view), &child_loc, child->anchor); /* Since anchored children are only ever allocated from * gtk_text_layout_get_line_display() we have to make sure * that the display line caching in the layout doesn't * get in the way. Invalidating the layout around the anchor * achieves this. */ if (_gtk_widget_get_alloc_needed (child->widget)) { GtkTextIter end = child_loc; gtk_text_iter_forward_char (&end); gtk_text_layout_invalidate (priv->layout, &child_loc, &end); } gtk_text_layout_validate_yrange (priv->layout, &child_loc, 0, 1); } } static GtkTextViewChild ** find_child_for_window_type (GtkTextView *text_view, GtkTextWindowType window_type) { switch (window_type) { case GTK_TEXT_WINDOW_LEFT: return &text_view->priv->left_child; case GTK_TEXT_WINDOW_RIGHT: return &text_view->priv->right_child; case GTK_TEXT_WINDOW_TOP: return &text_view->priv->top_child; case GTK_TEXT_WINDOW_BOTTOM: return &text_view->priv->bottom_child; case GTK_TEXT_WINDOW_TEXT: return &text_view->priv->center_child; case GTK_TEXT_WINDOW_WIDGET: default: return NULL; } } /** * gtk_text_view_get_gutter: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType * * Gets a #GtkWidget that has previously been set with * gtk_text_view_set_gutter(). * * @win must be one of %GTK_TEXT_WINDOW_LEFT, %GTK_TEXT_WINDOW_RIGHT, * %GTK_TEXT_WINDOW_TOP, or %GTK_TEXT_WINDOW_BOTTOM. * * Returns: (transfer none) (nullable): a #GtkWidget or %NULL */ GtkWidget * gtk_text_view_get_gutter (GtkTextView *text_view, GtkTextWindowType win) { GtkTextViewChild **childp; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); g_return_val_if_fail (win == GTK_TEXT_WINDOW_LEFT || win == GTK_TEXT_WINDOW_RIGHT || win == GTK_TEXT_WINDOW_TOP || win == GTK_TEXT_WINDOW_BOTTOM, NULL); childp = find_child_for_window_type (text_view, win); if (childp != NULL && *childp != NULL) return GTK_WIDGET (*childp); return NULL; } /** * gtk_text_view_set_gutter: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType * @widget: (nullable): a #GtkWidget or %NULL * * Places @widget into the gutter specified by @win. * * @win must be one of %GTK_TEXT_WINDOW_LEFT, %GTK_TEXT_WINDOW_RIGHT, * %GTK_TEXT_WINDOW_TOP, or %GTK_TEXT_WINDOW_BOTTOM. */ void gtk_text_view_set_gutter (GtkTextView *text_view, GtkTextWindowType win, GtkWidget *widget) { GtkTextViewChild **childp; GtkTextViewChild *old_child; GtkTextViewChild *new_child; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (widget == NULL || GTK_IS_WIDGET (widget)); g_return_if_fail (win == GTK_TEXT_WINDOW_LEFT || win == GTK_TEXT_WINDOW_RIGHT || win == GTK_TEXT_WINDOW_TOP || win == GTK_TEXT_WINDOW_BOTTOM); childp = find_child_for_window_type (text_view, win); if (childp == NULL) return; old_child = *childp; if ((GtkWidget *)old_child == widget) return; if (old_child != NULL) { *childp = NULL; gtk_widget_unparent (GTK_WIDGET (old_child)); g_object_unref (old_child); } if (widget == NULL) return; new_child = GTK_TEXT_VIEW_CHILD (gtk_text_view_child_new (win)); gtk_text_view_child_add (new_child, widget); *childp = g_object_ref (new_child); gtk_widget_set_parent (GTK_WIDGET (new_child), GTK_WIDGET (text_view)); update_node_ordering (GTK_WIDGET (text_view)); } static void gtk_text_view_size_allocate (GtkWidget *widget, int widget_width, int widget_height, int baseline) { GtkTextView *text_view; GtkTextViewPrivate *priv; int width, height; GdkRectangle text_rect; GdkRectangle left_rect; GdkRectangle right_rect; GdkRectangle top_rect; GdkRectangle bottom_rect; GtkWidget *chooser; PangoLayout *layout; guint mru_size; text_view = GTK_TEXT_VIEW (widget); priv = text_view->priv; DV(g_print(G_STRLOC"\n")); gtk_text_view_measure_borders (text_view, &priv->border_window_size); /* distribute width/height among child windows. Ensure all * windows get at least a 1x1 allocation. */ left_rect.width = priv->border_window_size.left; right_rect.width = priv->border_window_size.right; width = widget_width - left_rect.width - right_rect.width; text_rect.width = MAX (1, width); top_rect.width = text_rect.width; bottom_rect.width = text_rect.width; top_rect.height = priv->border_window_size.top; bottom_rect.height = priv->border_window_size.bottom; height = widget_height - top_rect.height - bottom_rect.height; text_rect.height = MAX (1, height); left_rect.height = text_rect.height; right_rect.height = text_rect.height; /* Origins */ left_rect.x = 0; top_rect.y = 0; text_rect.x = left_rect.x + left_rect.width; text_rect.y = top_rect.y + top_rect.height; left_rect.y = text_rect.y; right_rect.y = text_rect.y; top_rect.x = text_rect.x; bottom_rect.x = text_rect.x; right_rect.x = text_rect.x + text_rect.width; bottom_rect.y = text_rect.y + text_rect.height; text_window_size_allocate (priv->text_window, &text_rect); if (priv->center_child) { gtk_text_view_child_set_offset (priv->center_child, priv->xoffset, priv->yoffset); gtk_widget_size_allocate (GTK_WIDGET (priv->center_child), &text_rect, -1); } if (priv->left_child) { gtk_text_view_child_set_offset (priv->left_child, priv->xoffset, priv->yoffset); gtk_widget_size_allocate (GTK_WIDGET (priv->left_child), &left_rect, -1); } if (priv->right_child) { gtk_text_view_child_set_offset (priv->right_child, priv->xoffset, priv->yoffset); gtk_widget_size_allocate (GTK_WIDGET (priv->right_child), &right_rect, -1); } if (priv->top_child) { gtk_text_view_child_set_offset (priv->top_child, priv->xoffset, priv->yoffset); gtk_widget_size_allocate (GTK_WIDGET (priv->top_child), &top_rect, -1); } if (priv->bottom_child) { gtk_text_view_child_set_offset (priv->bottom_child, priv->xoffset, priv->yoffset); gtk_widget_size_allocate (GTK_WIDGET (priv->bottom_child), &bottom_rect, -1); } gtk_text_view_update_layout_width (text_view); /* Note that this will do some layout validation */ gtk_text_view_allocate_children (text_view); /* Update adjustments */ if (!gtk_adjustment_is_animating (priv->hadjustment)) gtk_text_view_set_hadjustment_values (text_view); if (!gtk_adjustment_is_animating (priv->vadjustment)) gtk_text_view_set_vadjustment_values (text_view); /* Optimize display cache size */ layout = gtk_widget_create_pango_layout (widget, "X"); pango_layout_get_pixel_size (layout, &width, &height); if (height > 0) { mru_size = SCREEN_HEIGHT (widget) / height * 3; gtk_text_layout_set_mru_size (priv->layout, mru_size); } g_object_unref (layout); /* The GTK resize loop processes all the pending exposes right * after doing the resize stuff, so the idle sizer won't have a * chance to run. So we do the work here. */ gtk_text_view_flush_first_validate (text_view); chooser = g_object_get_data (G_OBJECT (text_view), "gtk-emoji-chooser"); if (chooser) gtk_native_check_resize (GTK_NATIVE (chooser)); if (priv->magnifier_popover) gtk_native_check_resize (GTK_NATIVE (priv->magnifier_popover)); if (priv->popup_menu) gtk_native_check_resize (GTK_NATIVE (priv->popup_menu)); if (priv->text_handles[TEXT_HANDLE_CURSOR]) gtk_native_check_resize (GTK_NATIVE (priv->text_handles[TEXT_HANDLE_CURSOR])); if (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]) gtk_native_check_resize (GTK_NATIVE (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND])); if (priv->selection_bubble) gtk_native_check_resize (GTK_NATIVE (priv->selection_bubble)); } static void gtk_text_view_get_first_para_iter (GtkTextView *text_view, GtkTextIter *iter) { gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), iter, text_view->priv->first_para_mark); } static void gtk_text_view_validate_onscreen (GtkTextView *text_view) { GtkWidget *widget; GtkTextViewPrivate *priv; widget = GTK_WIDGET (text_view); priv = text_view->priv; DV(g_print(">Validating onscreen ("G_STRLOC")\n")); if (SCREEN_HEIGHT (widget) > 0) { GtkTextIter first_para; /* Be sure we've validated the stuff onscreen; if we * scrolled, these calls won't have any effect, because * they were called in the recursive validate_onscreen */ gtk_text_view_get_first_para_iter (text_view, &first_para); gtk_text_layout_validate_yrange (priv->layout, &first_para, 0, priv->first_para_pixels + SCREEN_HEIGHT (widget)); } priv->onscreen_validated = TRUE; DV(g_print(">Done validating onscreen, onscreen_validated = TRUE ("G_STRLOC")\n")); /* This can have the odd side effect of triggering a scroll, which should * flip "onscreen_validated" back to FALSE, but should also get us * back into this function to turn it on again. */ gtk_text_view_update_adjustments (text_view); g_assert (priv->onscreen_validated); } static void gtk_text_view_flush_first_validate (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (priv->first_validate_idle == 0) return; /* Do this first, which means that if an "invalidate" * occurs during any of this process, a new first_validate_callback * will be installed, and we'll start again. */ DV (g_print ("removing first validate in %s\n", G_STRLOC)); g_source_remove (priv->first_validate_idle); priv->first_validate_idle = 0; /* be sure we have up-to-date screen size set on the * layout. */ gtk_text_view_update_layout_width (text_view); /* Bail out if we invalidated stuff; scrolling right away will just * confuse the issue. */ if (priv->first_validate_idle != 0) { DV(g_print(">Width change forced requeue ("G_STRLOC")\n")); } else { /* scroll to any marks, if that's pending. This can jump us to * the validation codepath used for scrolling onscreen, if so we * bail out. It won't jump if already in that codepath since * value_changed is not recursive, so also validate if * necessary. */ if (!gtk_text_view_flush_scroll (text_view) || !priv->onscreen_validated) gtk_text_view_validate_onscreen (text_view); DV(g_print(">Leaving first validate idle ("G_STRLOC")\n")); g_assert (priv->onscreen_validated); } } static gboolean first_validate_callback (gpointer data) { GtkTextView *text_view = data; /* Note that some of this code is duplicated at the end of size_allocate, * keep in sync with that. */ DV(g_print(G_STRLOC"\n")); gtk_text_view_flush_first_validate (text_view); return FALSE; } static gboolean incremental_validate_callback (gpointer data) { GtkTextView *text_view = data; gboolean result = TRUE; DV(g_print(G_STRLOC"\n")); gtk_text_layout_validate (text_view->priv->layout, 2000); gtk_text_view_update_adjustments (text_view); if (gtk_text_layout_is_valid (text_view->priv->layout)) { text_view->priv->incremental_validate_idle = 0; result = FALSE; } return result; } static void gtk_text_view_invalidate (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; DV (g_print (">Invalidate, onscreen_validated = %d now FALSE ("G_STRLOC")\n", priv->onscreen_validated)); priv->onscreen_validated = FALSE; /* We'll invalidate when the layout is created */ if (priv->layout == NULL) return; if (!priv->first_validate_idle) { priv->first_validate_idle = g_idle_add_full (GTK_PRIORITY_RESIZE - 2, first_validate_callback, text_view, NULL); g_source_set_name_by_id (priv->first_validate_idle, "[gtk] first_validate_callback"); DV (g_print (G_STRLOC": adding first validate idle %d\n", priv->first_validate_idle)); } if (!priv->incremental_validate_idle) { priv->incremental_validate_idle = g_idle_add_full (GTK_TEXT_VIEW_PRIORITY_VALIDATE, incremental_validate_callback, text_view, NULL); g_source_set_name_by_id (priv->incremental_validate_idle, "[gtk] incremental_validate_callback"); DV (g_print (G_STRLOC": adding incremental validate idle %d\n", priv->incremental_validate_idle)); } } static void invalidated_handler (GtkTextLayout *layout, gpointer data) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (data); DV (g_print ("Invalidating due to layout invalidate signal\n")); gtk_text_view_invalidate (text_view); } static void changed_handler (GtkTextLayout *layout, int start_y, int old_height, int new_height, gpointer data) { GtkTextView *text_view; GtkTextViewPrivate *priv; GtkWidget *widget; text_view = GTK_TEXT_VIEW (data); priv = text_view->priv; widget = GTK_WIDGET (data); DV(g_print(">Lines Validated ("G_STRLOC")\n")); if (gtk_widget_get_realized (widget)) { gtk_widget_queue_draw (widget); DV(g_print(" invalidated rect: %d,%d %d x %d\n", redraw_rect.x, redraw_rect.y, redraw_rect.width, redraw_rect.height)); queue_update_im_spot_location (text_view); } if (old_height != new_height) { const GList *iter; GtkTextIter first; int new_first_para_top; int old_first_para_top; /* If the bottom of the old area was above the top of the * screen, we need to scroll to keep the current top of the * screen in place. Remember that first_para_pixels is the * position of the top of the screen in coordinates relative to * the first paragraph onscreen. * * In short we are adding the height delta of the portion of the * changed region above first_para_mark to priv->yoffset. */ gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &first, priv->first_para_mark); gtk_text_layout_get_line_yrange (layout, &first, &new_first_para_top, NULL); old_first_para_top = priv->yoffset - priv->first_para_pixels + priv->top_margin; if (new_first_para_top != old_first_para_top) { priv->yoffset += new_first_para_top - old_first_para_top; gtk_adjustment_set_value (text_view->priv->vadjustment, priv->yoffset); } /* FIXME be smarter about which anchored widgets we update */ for (iter = priv->anchored_children.head; iter; iter = iter->next) { const AnchoredChild *ac = iter->data; gtk_text_view_update_child_allocation (text_view, ac); } gtk_widget_queue_resize (widget); } } static void gtk_text_view_realize (GtkWidget *widget) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (widget); priv = text_view->priv; GTK_WIDGET_CLASS (gtk_text_view_parent_class)->realize (widget); if (gtk_widget_is_sensitive (widget)) { gtk_im_context_set_client_widget (GTK_TEXT_VIEW (widget)->priv->im_context, widget); } gtk_text_view_ensure_layout (text_view); gtk_text_view_invalidate (text_view); if (priv->buffer) { GdkClipboard *clipboard = gtk_widget_get_primary_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_add_selection_clipboard (priv->buffer, clipboard); } /* Ensure updating the spot location. */ gtk_text_view_update_im_spot_location (text_view); } static void gtk_text_view_unrealize (GtkWidget *widget) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (widget); priv = text_view->priv; if (priv->buffer) { GdkClipboard *clipboard = gtk_widget_get_primary_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_remove_selection_clipboard (priv->buffer, clipboard); } gtk_text_view_remove_validate_idles (text_view); g_clear_pointer (&priv->popup_menu, gtk_widget_unparent); gtk_im_context_set_client_widget (priv->im_context, NULL); GTK_WIDGET_CLASS (gtk_text_view_parent_class)->unrealize (widget); } static void gtk_text_view_map (GtkWidget *widget) { gtk_widget_set_cursor_from_name (widget, "text"); GTK_WIDGET_CLASS (gtk_text_view_parent_class)->map (widget); } static void gtk_text_view_css_changed (GtkWidget *widget, GtkCssStyleChange *change) { GtkTextView *text_view; GtkTextViewPrivate *priv; PangoContext *ltr_context, *rtl_context; text_view = GTK_TEXT_VIEW (widget); priv = text_view->priv; GTK_WIDGET_CLASS (gtk_text_view_parent_class)->css_changed (widget, change); if ((change == NULL || gtk_css_style_change_affects (change, GTK_CSS_AFFECTS_TEXT | GTK_CSS_AFFECTS_BACKGROUND | GTK_CSS_AFFECTS_CONTENT)) && priv->layout && priv->layout->default_style) { gtk_text_view_set_attributes_from_style (text_view, priv->layout->default_style); gtk_text_layout_default_style_changed (priv->layout); ltr_context = gtk_widget_create_pango_context (widget); pango_context_set_base_dir (ltr_context, PANGO_DIRECTION_LTR); rtl_context = gtk_widget_create_pango_context (widget); pango_context_set_base_dir (rtl_context, PANGO_DIRECTION_RTL); gtk_text_layout_set_contexts (priv->layout, ltr_context, rtl_context); g_object_unref (ltr_context); g_object_unref (rtl_context); } } static void gtk_text_view_direction_changed (GtkWidget *widget, GtkTextDirection previous_direction) { GtkTextViewPrivate *priv = GTK_TEXT_VIEW (widget)->priv; if (priv->layout && priv->layout->default_style) { priv->layout->default_style->direction = gtk_widget_get_direction (widget); gtk_text_layout_default_style_changed (priv->layout); } } static void gtk_text_view_state_flags_changed (GtkWidget *widget, GtkStateFlags previous_state) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; GtkStateFlags state; if (!gtk_widget_is_sensitive (widget)) { /* Clear any selection */ gtk_text_view_unselect (text_view); } state = gtk_widget_get_state_flags (widget); gtk_css_node_set_state (priv->text_window->css_node, state); state &= ~GTK_STATE_FLAG_DROP_ACTIVE; gtk_css_node_set_state (priv->selection_node, state); gtk_widget_queue_draw (widget); } static void gtk_text_view_obscure_mouse_cursor (GtkTextView *text_view) { if (text_view->priv->mouse_cursor_obscured) return; gtk_widget_set_cursor_from_name (GTK_WIDGET (text_view), "none"); text_view->priv->mouse_cursor_obscured = TRUE; } static void gtk_text_view_unobscure_mouse_cursor (GtkTextView *text_view) { if (text_view->priv->mouse_cursor_obscured) { gtk_widget_set_cursor_from_name (GTK_WIDGET (text_view), "text"); text_view->priv->mouse_cursor_obscured = FALSE; } } /* * Events */ static void _text_window_to_widget_coords (GtkTextView *text_view, int *x, int *y) { GtkTextViewPrivate *priv = text_view->priv; (*x) += priv->border_window_size.left; (*y) += priv->border_window_size.top; } static void _widget_to_text_surface_coords (GtkTextView *text_view, int *x, int *y) { GtkTextViewPrivate *priv = text_view->priv; (*x) -= priv->border_window_size.left; (*y) -= priv->border_window_size.top; } static void gtk_text_view_set_handle_position (GtkTextView *text_view, GtkTextHandle *handle, GtkTextIter *iter) { GtkTextViewPrivate *priv; GdkRectangle rect; int x, y; priv = text_view->priv; gtk_text_view_get_cursor_locations (text_view, iter, &rect, NULL); x = rect.x - priv->xoffset; y = rect.y - priv->yoffset; if (!gtk_text_handle_get_is_dragged (handle) && (x < 0 || x > SCREEN_WIDTH (text_view) || y < 0 || y > SCREEN_HEIGHT (text_view))) { /* Hide the handle if it's not being manipulated * and fell outside of the visible text area. */ gtk_widget_hide (GTK_WIDGET (handle)); } else { GtkTextDirection dir = GTK_TEXT_DIR_LTR; GtkTextAttributes attributes = { 0 }; gtk_widget_show (GTK_WIDGET (handle)); rect.x = CLAMP (x, 0, SCREEN_WIDTH (text_view)); rect.y = CLAMP (y, 0, SCREEN_HEIGHT (text_view)); _text_window_to_widget_coords (text_view, &rect.x, &rect.y); gtk_text_handle_set_position (handle, &rect); if (gtk_text_iter_get_attributes (iter, &attributes)) dir = attributes.direction; gtk_widget_set_direction (GTK_WIDGET (handle), dir); } } static void gtk_text_view_show_magnifier (GtkTextView *text_view, GtkTextIter *iter, int x, int y) { cairo_rectangle_int_t rect; GtkTextViewPrivate *priv; GtkAllocation allocation; GtkRequisition req; #define N_LINES 1 gtk_widget_get_allocation (GTK_WIDGET (text_view), &allocation); priv = text_view->priv; _gtk_text_view_ensure_magnifier (text_view); /* Set size/content depending on iter rect */ gtk_text_view_get_iter_location (text_view, iter, (GdkRectangle *) &rect); rect.x = x + priv->xoffset; gtk_text_view_buffer_to_window_coords (text_view, GTK_TEXT_WINDOW_TEXT, rect.x, rect.y, &rect.x, &rect.y); _text_window_to_widget_coords (text_view, &rect.x, &rect.y); req.height = rect.height * N_LINES * _gtk_magnifier_get_magnification (GTK_MAGNIFIER (priv->magnifier)); req.width = MAX ((req.height * 4) / 3, 80); gtk_widget_set_size_request (priv->magnifier, req.width, req.height); _gtk_magnifier_set_coords (GTK_MAGNIFIER (priv->magnifier), rect.x, rect.y + rect.height / 2); rect.x = CLAMP (rect.x, 0, allocation.width); rect.y += rect.height / 4; rect.height -= rect.height / 4; gtk_popover_set_pointing_to (GTK_POPOVER (priv->magnifier_popover), &rect); gtk_popover_popup (GTK_POPOVER (priv->magnifier_popover)); #undef N_LINES } static void gtk_text_view_handle_dragged (GtkTextHandle *handle, int x, int y, GtkTextView *text_view) { GtkTextViewPrivate *priv; GtkTextIter cursor, bound, iter, *old_iter; GtkTextBuffer *buffer; priv = text_view->priv; buffer = get_buffer (text_view); _widget_to_text_surface_coords (text_view, &x, &y); gtk_text_view_selection_bubble_popup_unset (text_view); gtk_text_layout_get_iter_at_pixel (priv->layout, &iter, x + priv->xoffset, y + priv->yoffset); gtk_text_buffer_get_iter_at_mark (buffer, &cursor, gtk_text_buffer_get_insert (buffer)); gtk_text_buffer_get_iter_at_mark (buffer, &bound, gtk_text_buffer_get_selection_bound (buffer)); if (handle == priv->text_handles[TEXT_HANDLE_CURSOR]) { /* Avoid running past the other handle in selection mode */ if (gtk_text_iter_compare (&iter, &bound) >= 0 && gtk_widget_is_visible (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]))) { iter = bound; gtk_text_iter_backward_char (&iter); } old_iter = &cursor; gtk_text_view_set_handle_position (text_view, handle, &iter); } else if (handle == priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]) { /* Avoid running past the other handle */ if (gtk_text_iter_compare (&iter, &cursor) <= 0) { iter = cursor; gtk_text_iter_forward_char (&iter); } old_iter = &bound; gtk_text_view_set_handle_position (text_view, handle, &iter); } else g_assert_not_reached (); if (gtk_text_iter_compare (&iter, old_iter) != 0) { *old_iter = iter; if (handle == priv->text_handles[TEXT_HANDLE_CURSOR] && !gtk_widget_is_visible (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]))) gtk_text_buffer_place_cursor (buffer, &cursor); else gtk_text_buffer_select_range (buffer, &cursor, &bound); if (handle == priv->text_handles[TEXT_HANDLE_CURSOR]) { text_view->priv->cursor_handle_dragged = TRUE; gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (buffer)); } else if (handle == priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]) { text_view->priv->selection_handle_dragged = TRUE; gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_selection_bound (buffer)); } gtk_text_view_update_handles (text_view); } gtk_text_view_show_magnifier (text_view, &iter, x, y); } static void gtk_text_view_handle_drag_started (GtkTextHandle *handle, GtkTextView *text_view) { text_view->priv->cursor_handle_dragged = FALSE; text_view->priv->selection_handle_dragged = FALSE; } static void gtk_text_view_handle_drag_finished (GtkTextHandle *handle, GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (!priv->cursor_handle_dragged && !priv->selection_handle_dragged) { GtkTextBuffer *buffer; GtkTextIter cursor, start, end; GtkSettings *settings; guint double_click_time; settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); g_object_get (settings, "gtk-double-click-time", &double_click_time, NULL); if (g_get_monotonic_time() - priv->handle_place_time < double_click_time * 1000) { buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &cursor, gtk_text_buffer_get_insert (buffer)); extend_selection (text_view, SELECT_WORDS, &cursor, &start, &end); gtk_text_buffer_select_range (buffer, &start, &end); gtk_text_view_update_handles (text_view); } else gtk_text_view_selection_bubble_popup_set (text_view); } if (priv->magnifier_popover) gtk_popover_popdown (GTK_POPOVER (priv->magnifier_popover)); } static gboolean cursor_visible (GtkTextView *text_view); static void gtk_text_view_update_handles (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GtkTextIter cursor, bound; GtkTextBuffer *buffer; if (!priv->text_handles_enabled) { if (priv->text_handles[TEXT_HANDLE_CURSOR]) gtk_widget_hide (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_CURSOR])); if (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND]) gtk_widget_hide (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND])); } else { _gtk_text_view_ensure_text_handles (text_view); buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &cursor, gtk_text_buffer_get_insert (buffer)); gtk_text_buffer_get_iter_at_mark (buffer, &bound, gtk_text_buffer_get_selection_bound (buffer)); if (gtk_text_iter_compare (&cursor, &bound) == 0 && priv->editable) { /* Cursor mode */ gtk_widget_hide (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND])); gtk_text_view_set_handle_position (text_view, priv->text_handles[TEXT_HANDLE_CURSOR], &cursor); gtk_text_handle_set_role (priv->text_handles[TEXT_HANDLE_CURSOR], GTK_TEXT_HANDLE_ROLE_CURSOR); gtk_widget_show (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_CURSOR])); } else if (gtk_text_iter_compare (&cursor, &bound) != 0) { /* Selection mode */ gtk_text_view_set_handle_position (text_view, priv->text_handles[TEXT_HANDLE_CURSOR], &cursor); gtk_text_handle_set_role (priv->text_handles[TEXT_HANDLE_CURSOR], GTK_TEXT_HANDLE_ROLE_SELECTION_START); gtk_widget_show (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_CURSOR])); gtk_text_view_set_handle_position (text_view, priv->text_handles[TEXT_HANDLE_SELECTION_BOUND], &bound); gtk_text_handle_set_role (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND], GTK_TEXT_HANDLE_ROLE_SELECTION_END); gtk_widget_show (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND])); } else { gtk_widget_hide (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_CURSOR])); gtk_widget_hide (GTK_WIDGET (priv->text_handles[TEXT_HANDLE_SELECTION_BOUND])); } } } static gboolean gtk_text_view_key_controller_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkTextView *text_view) { GtkTextViewPrivate *priv; gboolean retval = FALSE; priv = text_view->priv; if (priv->layout == NULL || get_buffer (text_view) == NULL) return FALSE; /* Make sure input method knows where it is */ flush_update_im_spot_location (text_view); /* use overall editability not can_insert, more predictable for users */ if (priv->editable && (keyval == GDK_KEY_Return || keyval == GDK_KEY_ISO_Enter || keyval == GDK_KEY_KP_Enter)) { /* this won't actually insert the newline if the cursor isn't * editable */ gtk_text_view_reset_im_context (text_view); gtk_text_view_commit_text (text_view, "\n"); retval = TRUE; } /* Pass through Tab as literal tab, unless Control is held down */ else if ((keyval == GDK_KEY_Tab || keyval == GDK_KEY_KP_Tab || keyval == GDK_KEY_ISO_Left_Tab) && !(state & GDK_CONTROL_MASK)) { /* If the text widget isn't editable overall, or if the application * has turned off "accepts_tab", move the focus instead */ if (priv->accepts_tab && priv->editable) { gtk_text_view_reset_im_context (text_view); gtk_text_view_commit_text (text_view, "\t"); } else g_signal_emit_by_name (text_view, "move-focus", (state & GDK_SHIFT_MASK) ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD); retval = TRUE; } else retval = FALSE; gtk_text_view_reset_blink_time (text_view); gtk_text_view_pend_cursor_blink (text_view); text_view->priv->text_handles_enabled = FALSE; gtk_text_view_update_handles (text_view); gtk_text_view_selection_bubble_popup_unset (text_view); return retval; } static void gtk_text_view_key_controller_im_update (GtkEventControllerKey *controller, GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GtkTextMark *insert; GtkTextIter iter; gboolean can_insert; insert = gtk_text_buffer_get_insert (get_buffer (text_view)); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, insert); can_insert = gtk_text_iter_can_insert (&iter, priv->editable); priv->need_im_reset = TRUE; if (!can_insert) gtk_text_view_reset_im_context (text_view); } static gboolean get_iter_from_gesture (GtkTextView *text_view, GtkGesture *gesture, GtkTextIter *iter, int *x, int *y) { GdkEventSequence *sequence; GtkTextViewPrivate *priv; int xcoord, ycoord; double px, py; priv = text_view->priv; sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); if (!gtk_gesture_get_point (gesture, sequence, &px, &py)) return FALSE; xcoord = px + priv->xoffset; ycoord = py + priv->yoffset; _widget_to_text_surface_coords (text_view, &xcoord, &ycoord); gtk_text_layout_get_iter_at_pixel (priv->layout, iter, xcoord, ycoord); if (x) *x = xcoord; if (y) *y = ycoord; return TRUE; } static void gtk_text_view_click_gesture_pressed (GtkGestureClick *gesture, int n_press, double x, double y, GtkTextView *text_view) { GdkEventSequence *sequence; GtkTextViewPrivate *priv; GdkEvent *event; gboolean is_touchscreen; GdkDevice *device; GtkTextIter iter; guint button; priv = text_view->priv; sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); button = gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)); event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); gtk_widget_grab_focus (GTK_WIDGET (text_view)); gtk_text_view_reset_blink_time (text_view); device = gdk_event_get_device ((GdkEvent *) event); is_touchscreen = gtk_simulate_touchscreen () || gdk_device_get_source (device) == GDK_SOURCE_TOUCHSCREEN; if (n_press == 1) { /* Always emit reset when preedit is shown */ priv->need_im_reset = TRUE; gtk_text_view_reset_im_context (text_view); } if (n_press == 1 && gdk_event_triggers_context_menu (event)) { gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); gtk_text_view_do_popup (text_view, event); } else if (button == GDK_BUTTON_MIDDLE && get_middle_click_paste (text_view)) { gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); get_iter_from_gesture (text_view, GTK_GESTURE (gesture), &iter, NULL, NULL); gtk_text_buffer_paste_clipboard (get_buffer (text_view), gtk_widget_get_primary_clipboard (GTK_WIDGET (text_view)), &iter, priv->editable); } else if (button == GDK_BUTTON_PRIMARY) { gboolean extends = FALSE; GdkModifierType state; state = gdk_event_get_modifier_state (event); if (state & GDK_SHIFT_MASK) extends = TRUE; switch (n_press) { case 1: { /* If we're in the selection, start a drag copy/move of the * selection; otherwise, start creating a new selection. */ GtkTextIter start, end; priv->text_handles_enabled = is_touchscreen; get_iter_from_gesture (text_view, GTK_GESTURE (gesture), &iter, NULL, NULL); if (gtk_text_buffer_get_selection_bounds (get_buffer (text_view), &start, &end) && gtk_text_iter_in_range (&iter, &start, &end) && !extends) { if (is_touchscreen) { gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); if (!priv->selection_bubble || !gtk_widget_get_visible (priv->selection_bubble)) { gtk_text_view_selection_bubble_popup_set (text_view); priv->text_handles_enabled = FALSE; } else { gtk_text_view_selection_bubble_popup_unset (text_view); } } else { /* Claim the sequence on the drag gesture, but attach no * selection data, this is a special case to start DnD. */ gtk_gesture_set_state (priv->drag_gesture, GTK_EVENT_SEQUENCE_CLAIMED); } break; } else { gtk_text_view_selection_bubble_popup_unset (text_view); if (is_touchscreen) { gtk_text_buffer_place_cursor (get_buffer (text_view), &iter); priv->handle_place_time = g_get_monotonic_time (); } else gtk_text_view_start_selection_drag (text_view, &iter, SELECT_CHARACTERS, extends); } break; } case 2: case 3: gtk_text_view_end_selection_drag (text_view); get_iter_from_gesture (text_view, GTK_GESTURE (gesture), &iter, NULL, NULL); gtk_text_view_start_selection_drag (text_view, &iter, n_press == 2 ? SELECT_WORDS : SELECT_LINES, extends); break; default: break; } gtk_text_view_update_handles (text_view); } if (n_press >= 3) gtk_event_controller_reset (GTK_EVENT_CONTROLLER (gesture)); } static void direction_changed (GdkDevice *device, GParamSpec *pspec, GtkTextView *text_view) { gtk_text_view_check_keymap_direction (text_view); } static void gtk_text_view_focus_in (GtkWidget *widget) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; GdkSeat *seat; GdkDevice *keyboard; gtk_widget_queue_draw (widget); DV(g_print (G_STRLOC": focus_in\n")); gtk_text_view_reset_blink_time (text_view); if (cursor_visible (text_view) && priv->layout) { gtk_text_layout_set_cursor_visible (priv->layout, TRUE); gtk_text_view_check_cursor_blink (text_view); } seat = gdk_display_get_default_seat (gtk_widget_get_display (widget)); if (seat) keyboard = gdk_seat_get_keyboard (seat); else keyboard = NULL; if (keyboard) g_signal_connect (keyboard, "notify::direction", G_CALLBACK (direction_changed), text_view); gtk_text_view_check_keymap_direction (text_view); if (priv->editable) { priv->need_im_reset = TRUE; gtk_im_context_focus_in (priv->im_context); } } static void gtk_text_view_focus_out (GtkWidget *widget) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; GdkSeat *seat; GdkDevice *keyboard; gtk_text_view_end_selection_drag (text_view); gtk_widget_queue_draw (widget); DV(g_print (G_STRLOC": focus_out\n")); if (cursor_visible (text_view) && priv->layout) { gtk_text_view_check_cursor_blink (text_view); gtk_text_layout_set_cursor_visible (priv->layout, FALSE); } seat = gdk_display_get_default_seat (gtk_widget_get_display (widget)); if (seat) keyboard = gdk_seat_get_keyboard (seat); else keyboard = NULL; if (keyboard) g_signal_handlers_disconnect_by_func (keyboard, direction_changed, text_view); gtk_text_view_selection_bubble_popup_unset (text_view); text_view->priv->text_handles_enabled = FALSE; gtk_text_view_update_handles (text_view); if (priv->editable) { priv->need_im_reset = TRUE; gtk_im_context_focus_out (priv->im_context); } } static void gtk_text_view_motion (GtkEventController *controller, double x, double y, gpointer user_data) { gtk_text_view_unobscure_mouse_cursor (GTK_TEXT_VIEW (user_data)); } static void gtk_text_view_paint (GtkWidget *widget, GtkSnapshot *snapshot) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (widget); priv = text_view->priv; g_return_if_fail (priv->layout != NULL); g_return_if_fail (priv->xoffset >= - priv->left_padding); g_return_if_fail (priv->yoffset >= - priv->top_margin); while (priv->first_validate_idle != 0) { DV (g_print (G_STRLOC": first_validate_idle: %d\n", priv->first_validate_idle)); gtk_text_view_flush_first_validate (text_view); } if (!priv->onscreen_validated) { g_warning (G_STRLOC ": somehow some text lines were modified or scrolling occurred since the last validation of lines on the screen - may be a text widget bug."); g_assert_not_reached (); } gtk_snapshot_save (snapshot); gtk_snapshot_translate (snapshot, &GRAPHENE_POINT_INIT (-priv->xoffset, -priv->yoffset)); gtk_text_layout_snapshot (priv->layout, widget, snapshot, &(GdkRectangle) { priv->xoffset, priv->yoffset, gtk_widget_get_width (widget), gtk_widget_get_height (widget) }, priv->cursor_alpha); gtk_snapshot_restore (snapshot); } static void draw_text (GtkWidget *widget, GtkSnapshot *snapshot) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; GtkStyleContext *context; gboolean did_save = FALSE; if (priv->border_window_size.left || priv->border_window_size.top) { did_save = TRUE; gtk_snapshot_save (snapshot); gtk_snapshot_translate (snapshot, &GRAPHENE_POINT_INIT (priv->border_window_size.left, priv->border_window_size.top)); } gtk_snapshot_push_clip (snapshot, &GRAPHENE_RECT_INIT (0, 0, SCREEN_WIDTH (widget), SCREEN_HEIGHT (widget))); context = gtk_widget_get_style_context (widget); gtk_style_context_save_to_node (context, text_view->priv->text_window->css_node); gtk_snapshot_render_background (snapshot, context, -priv->xoffset, -priv->yoffset - priv->top_margin, MAX (SCREEN_WIDTH (text_view), priv->width), MAX (SCREEN_HEIGHT (text_view), priv->height)); gtk_snapshot_render_frame (snapshot, context, -priv->xoffset, -priv->yoffset - priv->top_margin, MAX (SCREEN_WIDTH (text_view), priv->width), MAX (SCREEN_HEIGHT (text_view), priv->height)); gtk_style_context_restore (context); if (GTK_TEXT_VIEW_GET_CLASS (text_view)->snapshot_layer != NULL) { gtk_snapshot_save (snapshot); gtk_snapshot_translate (snapshot, &GRAPHENE_POINT_INIT (-priv->xoffset, -priv->yoffset)); GTK_TEXT_VIEW_GET_CLASS (text_view)->snapshot_layer (text_view, GTK_TEXT_VIEW_LAYER_BELOW_TEXT, snapshot); gtk_snapshot_restore (snapshot); } gtk_text_view_paint (widget, snapshot); if (GTK_TEXT_VIEW_GET_CLASS (text_view)->snapshot_layer != NULL) { gtk_snapshot_save (snapshot); gtk_snapshot_translate (snapshot, &GRAPHENE_POINT_INIT (-priv->xoffset, -priv->yoffset)); GTK_TEXT_VIEW_GET_CLASS (text_view)->snapshot_layer (text_view, GTK_TEXT_VIEW_LAYER_ABOVE_TEXT, snapshot); gtk_snapshot_restore (snapshot); } gtk_snapshot_pop (snapshot); if (did_save) gtk_snapshot_restore (snapshot); } static inline void snapshot_text_view_child (GtkWidget *widget, GtkTextViewChild *child, GtkSnapshot *snapshot) { if (child != NULL) gtk_widget_snapshot_child (widget, GTK_WIDGET (child), snapshot); } static void gtk_text_view_snapshot (GtkWidget *widget, GtkSnapshot *snapshot) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; const GList *iter; DV(g_print (">Exposed ("G_STRLOC")\n")); draw_text (widget, snapshot); snapshot_text_view_child (widget, priv->left_child, snapshot); snapshot_text_view_child (widget, priv->right_child, snapshot); snapshot_text_view_child (widget, priv->top_child, snapshot); snapshot_text_view_child (widget, priv->bottom_child, snapshot); snapshot_text_view_child (widget, priv->center_child, snapshot); /* Propagate exposes to all unanchored children. * Anchored children are handled in gtk_text_view_paint(). */ for (iter = priv->anchored_children.head; iter; iter = iter->next) { const AnchoredChild *vc = iter->data; gtk_widget_snapshot_child (widget, vc->widget, snapshot); } } /** * gtk_text_view_remove: * @text_view: a #GtkTextView * @child: the child to remove * * Removes a child widget from @text_view. */ void gtk_text_view_remove (GtkTextView *text_view, GtkWidget *child) { GtkTextViewPrivate *priv = text_view->priv; AnchoredChild *ac; if (GTK_IS_TEXT_VIEW_CHILD (child)) { GtkTextViewChild *vc = GTK_TEXT_VIEW_CHILD (child); GtkTextViewChild **vcp; if (vc == priv->left_child) vcp = &priv->left_child; else if (vc == priv->right_child) vcp = &priv->right_child; else if (vc == priv->top_child) vcp = &priv->top_child; else if (vc == priv->bottom_child) vcp = &priv->bottom_child; else if (vc == priv->center_child) vcp = &priv->center_child; else vcp = NULL; if (vcp) { *vcp = NULL; gtk_widget_unparent (child); g_object_unref (child); return; } } ac = g_object_get_qdata (G_OBJECT (child), quark_text_view_child); if (ac == NULL) { g_warning ("%s is not a child of %s", G_OBJECT_TYPE_NAME (child), G_OBJECT_TYPE_NAME (text_view)); return; } g_queue_unlink (&priv->anchored_children, &ac->link); gtk_widget_unparent (ac->widget); anchored_child_free (ac); } #define CURSOR_ON_MULTIPLIER 2 #define CURSOR_OFF_MULTIPLIER 1 #define CURSOR_PEND_MULTIPLIER 3 #define CURSOR_DIVIDER 3 static gboolean cursor_blinks (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); gboolean blink; #ifdef DEBUG_VALIDATION_AND_SCROLLING return FALSE; #endif g_object_get (settings, "gtk-cursor-blink", &blink, NULL); if (!blink) return FALSE; if (text_view->priv->editable) { GtkTextMark *insert; GtkTextIter iter; insert = gtk_text_buffer_get_insert (get_buffer (text_view)); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, insert); if (gtk_text_iter_editable (&iter, text_view->priv->editable)) return blink; } return FALSE; } static gboolean cursor_visible (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); gboolean use_caret; g_object_get (settings, "gtk-keynav-use-caret", &use_caret, NULL); return use_caret || text_view->priv->cursor_visible; } static gboolean get_middle_click_paste (GtkTextView *text_view) { GtkSettings *settings; gboolean paste; settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); g_object_get (settings, "gtk-enable-primary-paste", &paste, NULL); return paste; } static int get_cursor_time (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); int time; g_object_get (settings, "gtk-cursor-blink-time", &time, NULL); return time; } static int get_cursor_blink_timeout (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); int time; g_object_get (settings, "gtk-cursor-blink-timeout", &time, NULL); return time; } /* * Blink! */ typedef struct { guint64 start; guint64 end; } BlinkData; static gboolean blink_cb (GtkWidget *widget, GdkFrameClock *clock, gpointer user_data); static void add_blink_timeout (GtkTextView *self, gboolean delay) { GtkTextViewPrivate *priv = self->priv; BlinkData *data; int blink_time; priv->blink_start_time = g_get_monotonic_time (); priv->cursor_alpha = 1.0; blink_time = get_cursor_time (self); data = g_new (BlinkData, 1); data->start = priv->blink_start_time; if (delay) data->start += blink_time * 1000 / 2; data->end = data->start + blink_time * 1000; priv->blink_tick = gtk_widget_add_tick_callback (GTK_WIDGET (self), blink_cb, data, g_free); } static void remove_blink_timeout (GtkTextView *self) { GtkTextViewPrivate *priv = self->priv; if (priv->blink_tick) { gtk_widget_remove_tick_callback (GTK_WIDGET (self), priv->blink_tick); priv->blink_tick = 0; } } static float blink_alpha (float phase) { /* keep it simple, and split the blink cycle evenly * into visible, fading out, invisible, fading in */ if (phase < 0.25) return 1; else if (phase < 0.5) return 1 - 4 * (phase - 0.25); else if (phase < 0.75) return 0; else return 4 * (phase - 0.75); } static gboolean blink_cb (GtkWidget *widget, GdkFrameClock *clock, gpointer user_data) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextViewPrivate *priv = text_view->priv; BlinkData *data = user_data; int blink_timeout; int blink_time; guint64 now; float phase; float alpha; g_assert (priv->layout); g_assert (cursor_visible (text_view)); blink_timeout = get_cursor_blink_timeout (text_view); blink_time = get_cursor_time (text_view); now = g_get_monotonic_time (); if (now > priv->blink_start_time + blink_timeout * 1000000) { /* we've blinked enough without the user doing anything, stop blinking */ priv->cursor_alpha = 1.0; remove_blink_timeout (text_view); gtk_widget_queue_draw (widget); return G_SOURCE_REMOVE; } phase = (now - data->start) / (float) (data->end - data->start); if (now >= data->end) { data->start = data->end; data->end = data->start + blink_time * 1000; } alpha = blink_alpha (phase); if (priv->cursor_alpha != alpha) { priv->cursor_alpha = alpha; gtk_widget_queue_draw (widget); } return G_SOURCE_CONTINUE; } static void gtk_text_view_stop_cursor_blink (GtkTextView *text_view) { remove_blink_timeout (text_view); } static void gtk_text_view_check_cursor_blink (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (cursor_blinks (text_view) && cursor_visible (text_view)) { if (!priv->blink_tick) add_blink_timeout (text_view, FALSE); } else { if (priv->blink_tick) remove_blink_timeout (text_view); } } static void gtk_text_view_pend_cursor_blink (GtkTextView *text_view) { if (cursor_blinks (text_view)) { remove_blink_timeout (text_view); add_blink_timeout (text_view, TRUE); } } static void gtk_text_view_reset_blink_time (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; priv->blink_start_time = g_get_monotonic_time (); } /* * Key binding handlers */ static gboolean gtk_text_view_move_iter_by_lines (GtkTextView *text_view, GtkTextIter *newplace, int count) { gboolean ret = TRUE; while (count < 0) { ret = gtk_text_layout_move_iter_to_previous_line (text_view->priv->layout, newplace); count++; } while (count > 0) { ret = gtk_text_layout_move_iter_to_next_line (text_view->priv->layout, newplace); count--; } return ret; } static void move_cursor (GtkTextView *text_view, const GtkTextIter *new_location, gboolean extend_selection) { if (extend_selection) gtk_text_buffer_move_mark_by_name (get_buffer (text_view), "insert", new_location); else gtk_text_buffer_place_cursor (get_buffer (text_view), new_location); gtk_text_view_check_cursor_blink (text_view); } static gboolean iter_line_is_rtl (const GtkTextIter *iter) { GtkTextIter start, end; char *text; PangoDirection direction; start = end = *iter; gtk_text_iter_set_line_offset (&start, 0); gtk_text_iter_forward_line (&end); text = gtk_text_iter_get_visible_text (&start, &end); direction = gdk_find_base_dir (text, -1); g_free (text); return direction == PANGO_DIRECTION_RTL; } static void gtk_text_view_move_cursor (GtkTextView *text_view, GtkMovementStep step, int count, gboolean extend_selection) { GtkTextViewPrivate *priv; GtkTextIter insert; GtkTextIter newplace; gboolean cancel_selection = FALSE; int cursor_x_pos = 0; GtkDirectionType leave_direction = -1; priv = text_view->priv; if (!cursor_visible (text_view)) { GtkScrollStep scroll_step; double old_xpos, old_ypos; switch (step) { case GTK_MOVEMENT_VISUAL_POSITIONS: leave_direction = count > 0 ? GTK_DIR_RIGHT : GTK_DIR_LEFT; G_GNUC_FALLTHROUGH; case GTK_MOVEMENT_LOGICAL_POSITIONS: case GTK_MOVEMENT_WORDS: scroll_step = GTK_SCROLL_HORIZONTAL_STEPS; break; case GTK_MOVEMENT_DISPLAY_LINE_ENDS: scroll_step = GTK_SCROLL_HORIZONTAL_ENDS; break; case GTK_MOVEMENT_DISPLAY_LINES: leave_direction = count > 0 ? GTK_DIR_DOWN : GTK_DIR_UP; G_GNUC_FALLTHROUGH; case GTK_MOVEMENT_PARAGRAPHS: case GTK_MOVEMENT_PARAGRAPH_ENDS: scroll_step = GTK_SCROLL_STEPS; break; case GTK_MOVEMENT_PAGES: scroll_step = GTK_SCROLL_PAGES; break; case GTK_MOVEMENT_HORIZONTAL_PAGES: scroll_step = GTK_SCROLL_HORIZONTAL_PAGES; break; case GTK_MOVEMENT_BUFFER_ENDS: scroll_step = GTK_SCROLL_ENDS; break; default: scroll_step = GTK_SCROLL_PAGES; break; } old_xpos = gtk_adjustment_get_value (priv->hadjustment); old_ypos = gtk_adjustment_get_value (priv->vadjustment); gtk_text_view_move_viewport (text_view, scroll_step, count); if ((old_xpos == gtk_adjustment_get_target_value (priv->hadjustment) && old_ypos == gtk_adjustment_get_target_value (priv->vadjustment)) && leave_direction != (GtkDirectionType)-1 && !gtk_widget_keynav_failed (GTK_WIDGET (text_view), leave_direction)) { g_signal_emit_by_name (text_view, "move-focus", leave_direction); } return; } gtk_text_view_reset_im_context (text_view); if (step == GTK_MOVEMENT_PAGES) { if (!gtk_text_view_scroll_pages (text_view, count, extend_selection)) gtk_widget_error_bell (GTK_WIDGET (text_view)); gtk_text_view_check_cursor_blink (text_view); gtk_text_view_pend_cursor_blink (text_view); return; } else if (step == GTK_MOVEMENT_HORIZONTAL_PAGES) { if (!gtk_text_view_scroll_hpages (text_view, count, extend_selection)) gtk_widget_error_bell (GTK_WIDGET (text_view)); gtk_text_view_check_cursor_blink (text_view); gtk_text_view_pend_cursor_blink (text_view); return; } gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); if (! extend_selection) { gboolean move_forward = count > 0; GtkTextIter sel_bound; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &sel_bound, gtk_text_buffer_get_selection_bound (get_buffer (text_view))); if (iter_line_is_rtl (&insert)) move_forward = !move_forward; /* if we move forward, assume the cursor is at the end of the selection; * if we move backward, assume the cursor is at the start */ if (move_forward) gtk_text_iter_order (&sel_bound, &insert); else gtk_text_iter_order (&insert, &sel_bound); /* if we actually have a selection, just move *to* the beginning/end * of the selection and not *from* there on LOGICAL_POSITIONS * and VISUAL_POSITIONS movement */ if (! gtk_text_iter_equal (&sel_bound, &insert)) cancel_selection = TRUE; } newplace = insert; if (step == GTK_MOVEMENT_DISPLAY_LINES) gtk_text_view_get_virtual_cursor_pos (text_view, &insert, &cursor_x_pos, NULL); switch (step) { case GTK_MOVEMENT_LOGICAL_POSITIONS: if (! cancel_selection) gtk_text_iter_forward_visible_cursor_positions (&newplace, count); break; case GTK_MOVEMENT_VISUAL_POSITIONS: if (! cancel_selection) gtk_text_layout_move_iter_visually (priv->layout, &newplace, count); break; case GTK_MOVEMENT_WORDS: if (iter_line_is_rtl (&newplace)) count *= -1; if (count < 0) gtk_text_iter_backward_visible_word_starts (&newplace, -count); else if (count > 0) { if (!gtk_text_iter_forward_visible_word_ends (&newplace, count)) gtk_text_iter_forward_to_line_end (&newplace); } break; case GTK_MOVEMENT_DISPLAY_LINES: if (count < 0) { leave_direction = GTK_DIR_UP; if (gtk_text_view_move_iter_by_lines (text_view, &newplace, count)) gtk_text_layout_move_iter_to_x (priv->layout, &newplace, cursor_x_pos); else gtk_text_iter_set_line_offset (&newplace, 0); } if (count > 0) { leave_direction = GTK_DIR_DOWN; if (gtk_text_view_move_iter_by_lines (text_view, &newplace, count)) gtk_text_layout_move_iter_to_x (priv->layout, &newplace, cursor_x_pos); else gtk_text_iter_forward_to_line_end (&newplace); } break; case GTK_MOVEMENT_DISPLAY_LINE_ENDS: if (count > 1) gtk_text_view_move_iter_by_lines (text_view, &newplace, --count); else if (count < -1) gtk_text_view_move_iter_by_lines (text_view, &newplace, ++count); if (count != 0) gtk_text_layout_move_iter_to_line_end (priv->layout, &newplace, count); break; case GTK_MOVEMENT_PARAGRAPHS: if (count > 0) { if (!gtk_text_iter_ends_line (&newplace)) { gtk_text_iter_forward_to_line_end (&newplace); --count; } gtk_text_iter_forward_visible_lines (&newplace, count); gtk_text_iter_forward_to_line_end (&newplace); } else if (count < 0) { if (gtk_text_iter_get_line_offset (&newplace) > 0) gtk_text_iter_set_line_offset (&newplace, 0); gtk_text_iter_forward_visible_lines (&newplace, count); gtk_text_iter_set_line_offset (&newplace, 0); } break; case GTK_MOVEMENT_PARAGRAPH_ENDS: if (count > 0) { if (!gtk_text_iter_ends_line (&newplace)) gtk_text_iter_forward_to_line_end (&newplace); } else if (count < 0) { gtk_text_iter_set_line_offset (&newplace, 0); } break; case GTK_MOVEMENT_BUFFER_ENDS: if (count > 0) gtk_text_buffer_get_end_iter (get_buffer (text_view), &newplace); else if (count < 0) gtk_text_buffer_get_iter_at_offset (get_buffer (text_view), &newplace, 0); break; case GTK_MOVEMENT_PAGES: case GTK_MOVEMENT_HORIZONTAL_PAGES: /* We handle these cases above and return early from them. */ default: g_assert_not_reached (); break; } /* call move_cursor() even if the cursor hasn't moved, since it cancels the selection */ move_cursor (text_view, &newplace, extend_selection); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); if (step == GTK_MOVEMENT_DISPLAY_LINES) gtk_text_view_set_virtual_cursor_pos (text_view, cursor_x_pos, -1); if (gtk_text_iter_equal (&insert, &newplace)) { if (leave_direction != (GtkDirectionType)-1) { if (!gtk_widget_keynav_failed (GTK_WIDGET (text_view), leave_direction)) g_signal_emit_by_name (text_view, "move-focus", leave_direction); } else if (!cancel_selection) gtk_widget_error_bell (GTK_WIDGET (text_view)); } gtk_text_view_check_cursor_blink (text_view); gtk_text_view_pend_cursor_blink (text_view); } static void gtk_text_view_move_viewport (GtkTextView *text_view, GtkScrollStep step, int count) { GtkAdjustment *adjustment; double increment; switch (step) { case GTK_SCROLL_STEPS: case GTK_SCROLL_PAGES: case GTK_SCROLL_ENDS: adjustment = text_view->priv->vadjustment; break; case GTK_SCROLL_HORIZONTAL_STEPS: case GTK_SCROLL_HORIZONTAL_PAGES: case GTK_SCROLL_HORIZONTAL_ENDS: adjustment = text_view->priv->hadjustment; break; default: adjustment = text_view->priv->vadjustment; break; } switch (step) { case GTK_SCROLL_STEPS: case GTK_SCROLL_HORIZONTAL_STEPS: increment = gtk_adjustment_get_step_increment (adjustment); break; case GTK_SCROLL_PAGES: case GTK_SCROLL_HORIZONTAL_PAGES: increment = gtk_adjustment_get_page_increment (adjustment); break; case GTK_SCROLL_ENDS: case GTK_SCROLL_HORIZONTAL_ENDS: increment = gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment); break; default: increment = 0.0; break; } gtk_adjustment_animate_to_value (adjustment, gtk_adjustment_get_value (adjustment) + count * increment); } static void gtk_text_view_set_anchor (GtkTextView *text_view) { GtkTextIter insert; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); gtk_text_buffer_create_mark (get_buffer (text_view), "anchor", &insert, TRUE); } static gboolean gtk_text_view_scroll_pages (GtkTextView *text_view, int count, gboolean extend_selection) { GtkTextViewPrivate *priv; GtkAdjustment *adjustment; int cursor_x_pos, cursor_y_pos; GtkTextMark *insert_mark; GtkTextIter old_insert; GtkTextIter new_insert; GtkTextIter anchor; double newval; double oldval; int y0, y1; priv = text_view->priv; g_return_val_if_fail (priv->vadjustment != NULL, FALSE); adjustment = priv->vadjustment; insert_mark = gtk_text_buffer_get_insert (get_buffer (text_view)); /* Make sure we start from the current cursor position, even * if it was offscreen, but don't queue more scrolls if we're * already behind. */ if (priv->pending_scroll) cancel_pending_scroll (text_view); else gtk_text_view_scroll_mark_onscreen (text_view, insert_mark); /* Validate the region that will be brought into view by the cursor motion */ gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &old_insert, insert_mark); if (count < 0) { gtk_text_view_get_first_para_iter (text_view, &anchor); y0 = gtk_adjustment_get_page_size (adjustment); y1 = gtk_adjustment_get_page_size (adjustment) + count * gtk_adjustment_get_page_increment (adjustment); } else { gtk_text_view_get_first_para_iter (text_view, &anchor); y0 = count * gtk_adjustment_get_page_increment (adjustment) + gtk_adjustment_get_page_size (adjustment); y1 = 0; } gtk_text_layout_validate_yrange (priv->layout, &anchor, y0, y1); /* FIXME do we need to update the adjustment ranges here? */ new_insert = old_insert; if (count < 0 && gtk_adjustment_get_value (adjustment) <= (gtk_adjustment_get_lower (adjustment) + 1e-12)) { /* already at top, just be sure we are at offset 0 */ gtk_text_buffer_get_start_iter (get_buffer (text_view), &new_insert); move_cursor (text_view, &new_insert, extend_selection); } else if (count > 0 && gtk_adjustment_get_value (adjustment) >= (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_page_size (adjustment) - 1e-12)) { /* already at bottom, just be sure we are at the end */ gtk_text_buffer_get_end_iter (get_buffer (text_view), &new_insert); move_cursor (text_view, &new_insert, extend_selection); } else { gtk_text_view_get_virtual_cursor_pos (text_view, NULL, &cursor_x_pos, &cursor_y_pos); oldval = newval = gtk_adjustment_get_target_value (adjustment); newval += count * gtk_adjustment_get_page_increment (adjustment); gtk_adjustment_animate_to_value (adjustment, newval); cursor_y_pos += newval - oldval; gtk_text_layout_get_iter_at_pixel (priv->layout, &new_insert, cursor_x_pos, cursor_y_pos); move_cursor (text_view, &new_insert, extend_selection); gtk_text_view_set_virtual_cursor_pos (text_view, cursor_x_pos, cursor_y_pos); } /* Adjust to have the cursor _entirely_ onscreen, move_mark_onscreen * only guarantees 1 pixel onscreen. */ DV(g_print (G_STRLOC": scrolling onscreen\n")); return !gtk_text_iter_equal (&old_insert, &new_insert); } static gboolean gtk_text_view_scroll_hpages (GtkTextView *text_view, int count, gboolean extend_selection) { GtkTextViewPrivate *priv; GtkAdjustment *adjustment; int cursor_x_pos, cursor_y_pos; GtkTextMark *insert_mark; GtkTextIter old_insert; GtkTextIter new_insert; double newval; double oldval; int y, height; priv = text_view->priv; g_return_val_if_fail (priv->hadjustment != NULL, FALSE); adjustment = priv->hadjustment; insert_mark = gtk_text_buffer_get_insert (get_buffer (text_view)); /* Make sure we start from the current cursor position, even * if it was offscreen, but don't queue more scrolls if we're * already behind. */ if (priv->pending_scroll) cancel_pending_scroll (text_view); else gtk_text_view_scroll_mark_onscreen (text_view, insert_mark); /* Validate the line that we're moving within. */ gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &old_insert, insert_mark); gtk_text_layout_get_line_yrange (priv->layout, &old_insert, &y, &height); gtk_text_layout_validate_yrange (priv->layout, &old_insert, y, y + height); /* FIXME do we need to update the adjustment ranges here? */ new_insert = old_insert; if (count < 0 && gtk_adjustment_get_value (adjustment) <= (gtk_adjustment_get_lower (adjustment) + 1e-12)) { /* already at far left, just be sure we are at offset 0 */ gtk_text_iter_set_line_offset (&new_insert, 0); move_cursor (text_view, &new_insert, extend_selection); } else if (count > 0 && gtk_adjustment_get_value (adjustment) >= (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_page_size (adjustment) - 1e-12)) { /* already at far right, just be sure we are at the end */ if (!gtk_text_iter_ends_line (&new_insert)) gtk_text_iter_forward_to_line_end (&new_insert); move_cursor (text_view, &new_insert, extend_selection); } else { gtk_text_view_get_virtual_cursor_pos (text_view, NULL, &cursor_x_pos, &cursor_y_pos); oldval = newval = gtk_adjustment_get_target_value (adjustment); newval += count * gtk_adjustment_get_page_increment (adjustment); gtk_adjustment_animate_to_value (adjustment, newval); cursor_x_pos += newval - oldval; gtk_text_layout_get_iter_at_pixel (priv->layout, &new_insert, cursor_x_pos, cursor_y_pos); move_cursor (text_view, &new_insert, extend_selection); gtk_text_view_set_virtual_cursor_pos (text_view, cursor_x_pos, cursor_y_pos); } /* FIXME for lines shorter than the overall widget width, this results in a * "bounce" effect as we scroll to the right of the widget, then scroll * back to get the end of the line onscreen. * http://bugzilla.gnome.org/show_bug.cgi?id=68963 */ /* Adjust to have the cursor _entirely_ onscreen, move_mark_onscreen * only guarantees 1 pixel onscreen. */ DV(g_print (G_STRLOC": scrolling onscreen\n")); return !gtk_text_iter_equal (&old_insert, &new_insert); } static gboolean whitespace (gunichar ch, gpointer user_data) { return (ch == ' ' || ch == '\t'); } static gboolean not_whitespace (gunichar ch, gpointer user_data) { return !whitespace (ch, user_data); } static gboolean find_whitepace_region (const GtkTextIter *center, GtkTextIter *start, GtkTextIter *end) { *start = *center; *end = *center; if (gtk_text_iter_backward_find_char (start, not_whitespace, NULL, NULL)) gtk_text_iter_forward_char (start); /* we want the first whitespace... */ if (whitespace (gtk_text_iter_get_char (end), NULL)) gtk_text_iter_forward_find_char (end, not_whitespace, NULL, NULL); return !gtk_text_iter_equal (start, end); } static void gtk_text_view_insert_at_cursor (GtkTextView *text_view, const char *str) { if (!gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), str, -1, text_view->priv->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } static void gtk_text_view_delete_from_cursor (GtkTextView *text_view, GtkDeleteType type, int count) { GtkTextViewPrivate *priv; GtkTextIter insert; GtkTextIter start; GtkTextIter end; gboolean leave_one = FALSE; priv = text_view->priv; gtk_text_view_reset_im_context (text_view); if (type == GTK_DELETE_CHARS) { /* Char delete deletes the selection, if one exists */ if (gtk_text_buffer_delete_selection (get_buffer (text_view), TRUE, priv->editable)) return; } gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); start = insert; end = insert; switch (type) { case GTK_DELETE_CHARS: gtk_text_iter_forward_cursor_positions (&end, count); break; case GTK_DELETE_WORD_ENDS: if (count > 0) gtk_text_iter_forward_word_ends (&end, count); else if (count < 0) gtk_text_iter_backward_word_starts (&start, 0 - count); break; case GTK_DELETE_WORDS: break; case GTK_DELETE_DISPLAY_LINE_ENDS: break; case GTK_DELETE_DISPLAY_LINES: break; case GTK_DELETE_PARAGRAPH_ENDS: if (count > 0) { /* If we're already at a newline, we need to * simply delete that newline, instead of * moving to the next one. */ if (gtk_text_iter_ends_line (&end)) { gtk_text_iter_forward_line (&end); --count; } while (count > 0) { if (!gtk_text_iter_forward_to_line_end (&end)) break; --count; } } else if (count < 0) { if (gtk_text_iter_starts_line (&start)) { gtk_text_iter_backward_line (&start); if (!gtk_text_iter_ends_line (&end)) gtk_text_iter_forward_to_line_end (&start); } else { gtk_text_iter_set_line_offset (&start, 0); } ++count; gtk_text_iter_backward_lines (&start, -count); } break; case GTK_DELETE_PARAGRAPHS: if (count > 0) { gtk_text_iter_set_line_offset (&start, 0); gtk_text_iter_forward_to_line_end (&end); /* Do the lines beyond the first. */ while (count > 1) { gtk_text_iter_forward_to_line_end (&end); --count; } } /* FIXME negative count? */ break; case GTK_DELETE_WHITESPACE: { find_whitepace_region (&insert, &start, &end); } break; default: break; } if (!gtk_text_iter_equal (&start, &end)) { gtk_text_buffer_begin_user_action (get_buffer (text_view)); if (gtk_text_buffer_delete_interactive (get_buffer (text_view), &start, &end, priv->editable)) { if (leave_one) gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), " ", 1, priv->editable); } else { gtk_widget_error_bell (GTK_WIDGET (text_view)); } gtk_text_buffer_end_user_action (get_buffer (text_view)); gtk_text_view_set_virtual_cursor_pos (text_view, -1, -1); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); } else { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } static void gtk_text_view_backspace (GtkTextView *text_view) { GtkTextViewPrivate *priv; GtkTextIter insert; priv = text_view->priv; gtk_text_view_reset_im_context (text_view); /* Backspace deletes the selection, if one exists */ if (gtk_text_buffer_delete_selection (get_buffer (text_view), TRUE, priv->editable)) return; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); if (gtk_text_buffer_backspace (get_buffer (text_view), &insert, TRUE, priv->editable)) { gtk_text_view_set_virtual_cursor_pos (text_view, -1, -1); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); } else { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } static void gtk_text_view_cut_clipboard (GtkTextView *text_view) { GdkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_cut_clipboard (get_buffer (text_view), clipboard, text_view->priv->editable); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); gtk_text_view_selection_bubble_popup_unset (text_view); } static void gtk_text_view_copy_clipboard (GtkTextView *text_view) { GdkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view)); gtk_text_buffer_copy_clipboard (get_buffer (text_view), clipboard); /* on copy do not scroll, we are already onscreen */ } static void gtk_text_view_paste_clipboard (GtkTextView *text_view) { GdkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view)); text_view->priv->scroll_after_paste = TRUE; gtk_text_buffer_paste_clipboard (get_buffer (text_view), clipboard, NULL, text_view->priv->editable); } static void gtk_text_view_paste_done_handler (GtkTextBuffer *buffer, GdkClipboard *clipboard, gpointer data) { GtkTextView *text_view = data; GtkTextViewPrivate *priv; priv = text_view->priv; if (priv->scroll_after_paste) { DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (buffer)); } priv->scroll_after_paste = FALSE; } static void gtk_text_view_buffer_changed_handler (GtkTextBuffer *buffer, gpointer data) { GtkTextView *text_view = data; gtk_text_view_update_handles (text_view); } static void gtk_text_view_toggle_overwrite (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; priv->overwrite_mode = !priv->overwrite_mode; if (priv->layout) gtk_text_layout_set_overwrite_mode (priv->layout, priv->overwrite_mode && priv->editable); gtk_widget_queue_draw (GTK_WIDGET (text_view)); gtk_text_view_pend_cursor_blink (text_view); g_object_notify (G_OBJECT (text_view), "overwrite"); } /** * gtk_text_view_get_overwrite: * @text_view: a #GtkTextView * * Returns whether the #GtkTextView is in overwrite mode or not. * * Returns: whether @text_view is in overwrite mode or not. **/ gboolean gtk_text_view_get_overwrite (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return text_view->priv->overwrite_mode; } /** * gtk_text_view_set_overwrite: * @text_view: a #GtkTextView * @overwrite: %TRUE to turn on overwrite mode, %FALSE to turn it off * * Changes the #GtkTextView overwrite mode. **/ void gtk_text_view_set_overwrite (GtkTextView *text_view, gboolean overwrite) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); overwrite = overwrite != FALSE; if (text_view->priv->overwrite_mode != overwrite) gtk_text_view_toggle_overwrite (text_view); } /** * gtk_text_view_set_accepts_tab: * @text_view: A #GtkTextView * @accepts_tab: %TRUE if pressing the Tab key should insert a tab * character, %FALSE, if pressing the Tab key should move the * keyboard focus. * * Sets the behavior of the text widget when the Tab key is pressed. * If @accepts_tab is %TRUE, a tab character is inserted. If @accepts_tab * is %FALSE the keyboard focus is moved to the next widget in the focus * chain. **/ void gtk_text_view_set_accepts_tab (GtkTextView *text_view, gboolean accepts_tab) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); accepts_tab = accepts_tab != FALSE; if (text_view->priv->accepts_tab != accepts_tab) { text_view->priv->accepts_tab = accepts_tab; g_object_notify (G_OBJECT (text_view), "accepts-tab"); } } /** * gtk_text_view_get_accepts_tab: * @text_view: A #GtkTextView * * Returns whether pressing the Tab key inserts a tab characters. * gtk_text_view_set_accepts_tab(). * * Returns: %TRUE if pressing the Tab key inserts a tab character, * %FALSE if pressing the Tab key moves the keyboard focus. **/ gboolean gtk_text_view_get_accepts_tab (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return text_view->priv->accepts_tab; } /* * Selections */ static void gtk_text_view_unselect (GtkTextView *text_view) { GtkTextIter insert; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); gtk_text_buffer_move_mark (get_buffer (text_view), gtk_text_buffer_get_selection_bound (get_buffer (text_view)), &insert); } static void move_mark_to_pointer_and_scroll (GtkTextView *text_view, const char *mark_name) { GtkTextIter newplace; GtkTextBuffer *buffer; GtkTextMark *mark; buffer = get_buffer (text_view); get_iter_from_gesture (text_view, text_view->priv->drag_gesture, &newplace, NULL, NULL); mark = gtk_text_buffer_get_mark (buffer, mark_name); /* This may invalidate the layout */ DV(g_print (G_STRLOC": move mark\n")); gtk_text_buffer_move_mark (buffer, mark, &newplace); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, mark); DV (g_print ("first validate idle leaving %s is %d\n", G_STRLOC, text_view->priv->first_validate_idle)); } static gboolean selection_scan_timeout (gpointer data) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (data); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); return TRUE; /* remain installed. */ } static void extend_selection (GtkTextView *text_view, SelectionGranularity granularity, const GtkTextIter *location, GtkTextIter *start, GtkTextIter *end) { GtkTextExtendSelection extend_selection_granularity; gboolean handled = FALSE; switch (granularity) { case SELECT_CHARACTERS: *start = *location; *end = *location; return; case SELECT_WORDS: extend_selection_granularity = GTK_TEXT_EXTEND_SELECTION_WORD; break; case SELECT_LINES: extend_selection_granularity = GTK_TEXT_EXTEND_SELECTION_LINE; break; default: g_assert_not_reached (); } g_signal_emit (text_view, signals[EXTEND_SELECTION], 0, extend_selection_granularity, location, start, end, &handled); if (!handled) { *start = *location; *end = *location; } } static gboolean gtk_text_view_extend_selection (GtkTextView *text_view, GtkTextExtendSelection granularity, const GtkTextIter *location, GtkTextIter *start, GtkTextIter *end) { *start = *location; *end = *location; switch (granularity) { case GTK_TEXT_EXTEND_SELECTION_WORD: if (gtk_text_iter_inside_word (start)) { if (!gtk_text_iter_starts_word (start)) gtk_text_iter_backward_visible_word_start (start); if (!gtk_text_iter_ends_word (end)) { if (!gtk_text_iter_forward_visible_word_end (end)) gtk_text_iter_forward_to_end (end); } } else { GtkTextIter tmp; /* @start is not contained in a word: the selection is extended to all * the white spaces between the end of the word preceding @start and * the start of the one following. */ tmp = *start; if (gtk_text_iter_backward_visible_word_start (&tmp)) gtk_text_iter_forward_visible_word_end (&tmp); if (gtk_text_iter_get_line (&tmp) == gtk_text_iter_get_line (start)) *start = tmp; else gtk_text_iter_set_line_offset (start, 0); tmp = *end; if (!gtk_text_iter_forward_visible_word_end (&tmp)) gtk_text_iter_forward_to_end (&tmp); if (gtk_text_iter_ends_word (&tmp)) gtk_text_iter_backward_visible_word_start (&tmp); if (gtk_text_iter_get_line (&tmp) == gtk_text_iter_get_line (end)) *end = tmp; else gtk_text_iter_forward_to_line_end (end); } break; case GTK_TEXT_EXTEND_SELECTION_LINE: if (gtk_text_view_starts_display_line (text_view, start)) { /* If on a display line boundary, we assume the user * clicked off the end of a line and we therefore select * the line before the boundary. */ gtk_text_view_backward_display_line_start (text_view, start); } else { /* start isn't on the start of a line, so we move it to the * start, and move end to the end unless it's already there. */ gtk_text_view_backward_display_line_start (text_view, start); if (!gtk_text_view_starts_display_line (text_view, end)) gtk_text_view_forward_display_line_end (text_view, end); } break; default: g_return_val_if_reached (GDK_EVENT_STOP); } return GDK_EVENT_STOP; } typedef struct { SelectionGranularity granularity; GtkTextMark *orig_start; GtkTextMark *orig_end; GtkTextBuffer *buffer; } SelectionData; static void selection_data_free (SelectionData *data) { if (data->orig_start != NULL) gtk_text_buffer_delete_mark (data->buffer, data->orig_start); if (data->orig_end != NULL) gtk_text_buffer_delete_mark (data->buffer, data->orig_end); g_object_unref (data->buffer); g_slice_free (SelectionData, data); } static gboolean drag_gesture_get_text_surface_coords (GtkGestureDrag *gesture, GtkTextView *text_view, int *start_x, int *start_y, int *x, int *y) { double sx, sy, ox, oy; if (!gtk_gesture_drag_get_start_point (gesture, &sx, &sy) || !gtk_gesture_drag_get_offset (gesture, &ox, &oy)) return FALSE; *start_x = sx; *start_y = sy; _widget_to_text_surface_coords (text_view, start_x, start_y); *x = sx + ox; *y = sy + oy; _widget_to_text_surface_coords (text_view, x, y); return TRUE; } static void gtk_text_view_drag_gesture_update (GtkGestureDrag *gesture, double offset_x, double offset_y, GtkTextView *text_view) { int start_x, start_y, x, y; GdkEventSequence *sequence; gboolean is_touchscreen; GdkEvent *event; SelectionData *data; GdkDevice *device; GtkTextIter cursor; data = g_object_get_qdata (G_OBJECT (gesture), quark_text_selection_data); sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); drag_gesture_get_text_surface_coords (gesture, text_view, &start_x, &start_y, &x, &y); device = gdk_event_get_device (event); is_touchscreen = gtk_simulate_touchscreen () || gdk_device_get_source (device) == GDK_SOURCE_TOUCHSCREEN; get_iter_from_gesture (text_view, text_view->priv->drag_gesture, &cursor, NULL, NULL); if (!data) { /* If no data is attached, the initial press happened within the current * text selection, check for drag and drop to be initiated. */ if (gtk_drag_check_threshold (GTK_WIDGET (text_view), start_x, start_y, x, y)) { if (!is_touchscreen) { GtkTextIter iter; int buffer_x, buffer_y; gtk_text_view_window_to_buffer_coords (text_view, GTK_TEXT_WINDOW_TEXT, start_x, start_y, &buffer_x, &buffer_y); gtk_text_layout_get_iter_at_pixel (text_view->priv->layout, &iter, buffer_x, buffer_y); gtk_text_view_start_selection_dnd (text_view, &iter, event, start_x, start_y); /* Deny the gesture so we don't get further updates */ gtk_gesture_set_state (text_view->priv->drag_gesture, GTK_EVENT_SEQUENCE_DENIED); return; } else { gtk_text_view_start_selection_drag (text_view, &cursor, SELECT_WORDS, TRUE); data = g_object_get_qdata (G_OBJECT (gesture), quark_text_selection_data); } } else return; } g_assert (data != NULL); /* Text selection */ if (data->granularity == SELECT_CHARACTERS) { move_mark_to_pointer_and_scroll (text_view, "insert"); } else { GtkTextIter start, end; GtkTextIter orig_start, orig_end; GtkTextBuffer *buffer; buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &orig_start, data->orig_start); gtk_text_buffer_get_iter_at_mark (buffer, &orig_end, data->orig_end); get_iter_from_gesture (text_view, text_view->priv->drag_gesture, &cursor, NULL, NULL); extend_selection (text_view, data->granularity, &cursor, &start, &end); /* either the selection extends to the front, or end (or not) */ if (gtk_text_iter_compare (&orig_start, &start) < 0) start = orig_start; if (gtk_text_iter_compare (&orig_end, &end) > 0) end = orig_end; gtk_text_buffer_select_range (buffer, &start, &end); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (buffer)); } /* If we had to scroll offscreen, insert a timeout to do so * again. Note that in the timeout, even if the mouse doesn't * move, due to this scroll xoffset/yoffset will have changed * and we'll need to scroll again. */ if (text_view->priv->scroll_timeout != 0) /* reset on every motion event */ g_source_remove (text_view->priv->scroll_timeout); text_view->priv->scroll_timeout = g_timeout_add (50, selection_scan_timeout, text_view); g_source_set_name_by_id (text_view->priv->scroll_timeout, "[gtk] selection_scan_timeout"); gtk_text_view_selection_bubble_popup_unset (text_view); if (is_touchscreen) { text_view->priv->text_handles_enabled = TRUE; gtk_text_view_update_handles (text_view); gtk_text_view_show_magnifier (text_view, &cursor, x, y); } } static void gtk_text_view_drag_gesture_end (GtkGestureDrag *gesture, double offset_x, double offset_y, GtkTextView *text_view) { gboolean is_touchscreen, clicked_in_selection; int start_x, start_y, x, y; GdkEventSequence *sequence; GtkTextViewPrivate *priv; GdkEvent *event; GdkDevice *device; priv = text_view->priv; sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); drag_gesture_get_text_surface_coords (gesture, text_view, &start_x, &start_y, &x, &y); clicked_in_selection = g_object_get_qdata (G_OBJECT (gesture), quark_text_selection_data) == NULL; g_object_set_qdata (G_OBJECT (gesture), quark_text_selection_data, NULL); gtk_text_view_unobscure_mouse_cursor (text_view); if (priv->scroll_timeout != 0) { g_source_remove (priv->scroll_timeout); priv->scroll_timeout = 0; } if (priv->magnifier_popover) gtk_widget_hide (priv->magnifier_popover); /* Check whether the drag was cancelled rather than finished */ if (!gtk_gesture_handles_sequence (GTK_GESTURE (gesture), sequence)) return; event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); device = gdk_event_get_device (event); is_touchscreen = gtk_simulate_touchscreen () || gdk_device_get_source (device) == GDK_SOURCE_TOUCHSCREEN; if (!is_touchscreen && clicked_in_selection && !gtk_drag_check_threshold (GTK_WIDGET (text_view), start_x, start_y, x, y)) { GtkTextIter iter; /* Unselect everything; we clicked inside selection, but * didn't move by the drag threshold, so just clear selection * and place cursor. */ gtk_text_layout_get_iter_at_pixel (priv->layout, &iter, x + priv->xoffset, y + priv->yoffset); gtk_text_buffer_place_cursor (get_buffer (text_view), &iter); gtk_text_view_check_cursor_blink (text_view); gtk_text_view_update_handles (text_view); } } static void gtk_text_view_start_selection_drag (GtkTextView *text_view, const GtkTextIter *iter, SelectionGranularity granularity, gboolean extend) { GtkTextViewPrivate *priv; GtkTextIter cursor, ins, bound; GtkTextIter orig_start, orig_end; GtkTextBuffer *buffer; SelectionData *data; priv = text_view->priv; data = g_slice_new0 (SelectionData); data->granularity = granularity; buffer = get_buffer (text_view); cursor = *iter; extend_selection (text_view, data->granularity, &cursor, &ins, &bound); orig_start = ins; orig_end = bound; if (extend) { /* Extend selection */ GtkTextIter old_ins, old_bound; GtkTextIter old_start, old_end; gtk_text_buffer_get_iter_at_mark (buffer, &old_ins, gtk_text_buffer_get_insert (buffer)); gtk_text_buffer_get_iter_at_mark (buffer, &old_bound, gtk_text_buffer_get_selection_bound (buffer)); old_start = old_ins; old_end = old_bound; gtk_text_iter_order (&old_start, &old_end); /* move the front cursor, if the mouse is in front of the selection. Should the * cursor however be inside the selection (this happens on triple click) then we * move the side which was last moved (current insert mark) */ if (gtk_text_iter_compare (&cursor, &old_start) <= 0 || (gtk_text_iter_compare (&cursor, &old_end) < 0 && gtk_text_iter_compare (&old_ins, &old_bound) <= 0)) { bound = old_end; } else { ins = bound; bound = old_start; } /* Store any previous selection */ if (gtk_text_iter_compare (&old_start, &old_end) != 0) { orig_start = old_ins; orig_end = old_bound; } } gtk_text_buffer_select_range (buffer, &ins, &bound); gtk_text_iter_order (&orig_start, &orig_end); data->orig_start = gtk_text_buffer_create_mark (buffer, NULL, &orig_start, TRUE); data->orig_end = gtk_text_buffer_create_mark (buffer, NULL, &orig_end, TRUE); data->buffer = g_object_ref (buffer); gtk_text_view_check_cursor_blink (text_view); g_object_set_qdata_full (G_OBJECT (priv->drag_gesture), quark_text_selection_data, data, (GDestroyNotify) selection_data_free); // gtk_gesture_set_state (priv->drag_gesture, // GTK_EVENT_SEQUENCE_CLAIMED); } /* returns whether we were really dragging */ static gboolean gtk_text_view_end_selection_drag (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = text_view->priv; if (!gtk_gesture_is_active (priv->drag_gesture)) return FALSE; if (priv->scroll_timeout != 0) { g_source_remove (priv->scroll_timeout); priv->scroll_timeout = 0; } if (priv->magnifier_popover) gtk_widget_hide (priv->magnifier_popover); return TRUE; } /* * Layout utils */ static void gtk_text_view_set_attributes_from_style (GtkTextView *text_view, GtkTextAttributes *values) { GtkStyleContext *context; const GdkRGBA black = { 0, }; const GdkRGBA *color; if (!values->appearance.bg_rgba) values->appearance.bg_rgba = gdk_rgba_copy (&black); if (!values->appearance.fg_rgba) values->appearance.fg_rgba = gdk_rgba_copy (&black); context = gtk_widget_get_style_context (GTK_WIDGET (text_view)); color = gtk_css_color_value_get_rgba (_gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BACKGROUND_COLOR)); *values->appearance.bg_rgba = *color; color = gtk_css_color_value_get_rgba (_gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_COLOR)); *values->appearance.fg_rgba = *color; if (values->font) pango_font_description_free (values->font); values->font = gtk_css_style_get_pango_font (gtk_style_context_lookup_style (context)); } static void gtk_text_view_check_keymap_direction (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); GdkSeat *seat; GdkDevice *keyboard; PangoDirection direction; GtkTextDirection new_cursor_dir; GtkTextDirection new_keyboard_dir; gboolean split_cursor; if (!priv->layout) return; seat = gdk_display_get_default_seat (gtk_widget_get_display (GTK_WIDGET (text_view))); if (seat) keyboard = gdk_seat_get_keyboard (seat); else keyboard = NULL; if (keyboard) direction = gdk_device_get_direction (keyboard); else direction = PANGO_DIRECTION_LTR; g_object_get (settings, "gtk-split-cursor", &split_cursor, NULL); if (direction == PANGO_DIRECTION_RTL) new_keyboard_dir = GTK_TEXT_DIR_RTL; else new_keyboard_dir = GTK_TEXT_DIR_LTR; if (split_cursor) new_cursor_dir = GTK_TEXT_DIR_NONE; else new_cursor_dir = new_keyboard_dir; gtk_text_layout_set_cursor_direction (priv->layout, new_cursor_dir); gtk_text_layout_set_keyboard_direction (priv->layout, new_keyboard_dir); } static void gtk_text_view_ensure_layout (GtkTextView *text_view) { GtkWidget *widget; GtkTextViewPrivate *priv; widget = GTK_WIDGET (text_view); priv = text_view->priv; if (priv->layout == NULL) { GtkTextAttributes *style; PangoContext *ltr_context, *rtl_context; const GList *iter; DV(g_print(G_STRLOC"\n")); priv->layout = gtk_text_layout_new (); g_signal_connect (priv->layout, "invalidated", G_CALLBACK (invalidated_handler), text_view); g_signal_connect (priv->layout, "changed", G_CALLBACK (changed_handler), text_view); g_signal_connect (priv->layout, "allocate-child", G_CALLBACK (gtk_anchored_child_allocated), text_view); if (get_buffer (text_view)) gtk_text_layout_set_buffer (priv->layout, get_buffer (text_view)); if ((gtk_widget_has_focus (widget) && cursor_visible (text_view))) gtk_text_view_pend_cursor_blink (text_view); else gtk_text_layout_set_cursor_visible (priv->layout, FALSE); gtk_text_layout_set_overwrite_mode (priv->layout, priv->overwrite_mode && priv->editable); ltr_context = gtk_widget_create_pango_context (GTK_WIDGET (text_view)); pango_context_set_base_dir (ltr_context, PANGO_DIRECTION_LTR); rtl_context = gtk_widget_create_pango_context (GTK_WIDGET (text_view)); pango_context_set_base_dir (rtl_context, PANGO_DIRECTION_RTL); gtk_text_layout_set_contexts (priv->layout, ltr_context, rtl_context); g_object_unref (ltr_context); g_object_unref (rtl_context); gtk_text_view_check_keymap_direction (text_view); style = gtk_text_attributes_new (); gtk_text_view_set_attributes_from_style (text_view, style); style->pixels_above_lines = priv->pixels_above_lines; style->pixels_below_lines = priv->pixels_below_lines; style->pixels_inside_wrap = priv->pixels_inside_wrap; style->left_margin = priv->left_margin; style->right_margin = priv->right_margin; priv->layout->right_padding = priv->right_padding; priv->layout->left_padding = priv->left_padding; style->indent = priv->indent; style->tabs = priv->tabs ? pango_tab_array_copy (priv->tabs) : NULL; style->wrap_mode = priv->wrap_mode; style->justification = priv->justify; style->direction = gtk_widget_get_direction (GTK_WIDGET (text_view)); gtk_text_layout_set_default_style (priv->layout, style); gtk_text_attributes_unref (style); /* Set layout for all anchored children */ iter = priv->anchored_children.head; while (iter != NULL) { const AnchoredChild *ac = iter->data; iter = iter->next; gtk_text_anchored_child_set_layout (ac->widget, priv->layout); /* ac may now be invalid! */ } } } GtkTextAttributes* gtk_text_view_get_default_attributes (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); gtk_text_view_ensure_layout (text_view); return gtk_text_attributes_copy (text_view->priv->layout->default_style); } static void gtk_text_view_destroy_layout (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (priv->layout) { const GList *iter; gtk_text_view_remove_validate_idles (text_view); g_signal_handlers_disconnect_by_func (priv->layout, invalidated_handler, text_view); g_signal_handlers_disconnect_by_func (priv->layout, changed_handler, text_view); iter = priv->anchored_children.head; while (iter != NULL) { const AnchoredChild *ac = iter->data; iter = iter->next; gtk_text_anchored_child_set_layout (ac->widget, NULL); /* vc may now be invalid! */ } gtk_text_view_stop_cursor_blink (text_view); gtk_text_view_end_selection_drag (text_view); g_object_unref (priv->layout); priv->layout = NULL; } } /** * gtk_text_view_reset_im_context: * @text_view: a #GtkTextView * * Reset the input method context of the text view if needed. * * This can be necessary in the case where modifying the buffer * would confuse on-going input method behavior. */ void gtk_text_view_reset_im_context (GtkTextView *text_view) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->priv->need_im_reset) { text_view->priv->need_im_reset = FALSE; gtk_im_context_reset (text_view->priv->im_context); } } /** * gtk_text_view_im_context_filter_keypress: * @text_view: a #GtkTextView * @event: the key event * * Allow the #GtkTextView input method to internally handle key press * and release events. If this function returns %TRUE, then no further * processing should be done for this key event. See * gtk_im_context_filter_keypress(). * * Note that you are expected to call this function from your handler * when overriding key event handling. This is needed in the case when * you need to insert your own key handling between the input method * and the default key event handling of the #GtkTextView. * * |[ * static gboolean * gtk_foo_bar_key_press_event (GtkWidget *widget, * GdkEvent *event) * { * guint keyval; * * gdk_event_get_keyval ((GdkEvent*)event, &keyval); * * if (keyval == GDK_KEY_Return || keyval == GDK_KEY_KP_Enter) * { * if (gtk_text_view_im_context_filter_keypress (GTK_TEXT_VIEW (widget), event)) * return TRUE; * } * * // Do some stuff * * return GTK_WIDGET_CLASS (gtk_foo_bar_parent_class)->key_press_event (widget, event); * } * ]| * * Returns: %TRUE if the input method handled the key event. */ gboolean gtk_text_view_im_context_filter_keypress (GtkTextView *text_view, GdkEvent *event) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return gtk_im_context_filter_keypress (text_view->priv->im_context, event); } /* * DND feature */ static void dnd_finished_cb (GdkDrag *drag, GtkTextView *self) { if (gdk_drag_get_selected_action (drag) == GDK_ACTION_MOVE) gtk_text_buffer_delete_selection (self->priv->buffer, TRUE, self->priv->editable); self->priv->drag = NULL; } static void dnd_cancel_cb (GdkDrag *drag, GdkDragCancelReason reason, GtkTextView *self) { self->priv->drag = NULL; } static void gtk_text_view_start_selection_dnd (GtkTextView *text_view, const GtkTextIter *iter, GdkEvent *event, int x, int y) { GtkWidget *widget = GTK_WIDGET (text_view); GtkTextBuffer *buffer = gtk_text_view_get_buffer (text_view); GdkContentProvider *content; GtkTextIter start, end; GdkDragAction actions; GdkSurface *surface; GdkDevice *device; GdkDrag *drag; if (text_view->priv->editable) actions = GDK_ACTION_COPY | GDK_ACTION_MOVE; else actions = GDK_ACTION_COPY; content = gtk_text_buffer_get_selection_content (buffer); surface = gdk_event_get_surface (event); device = gdk_event_get_device (event); drag = gdk_drag_begin (surface, device, content, actions, x, y); g_object_unref (content); g_signal_connect (drag, "dnd-finished", G_CALLBACK (dnd_finished_cb), text_view); g_signal_connect (drag, "cancel", G_CALLBACK (dnd_cancel_cb), text_view); if (gtk_text_buffer_get_selection_bounds (buffer, &start, &end)) { GdkPaintable *paintable; paintable = gtk_text_util_create_rich_drag_icon (widget, buffer, &start, &end); gtk_drag_icon_set_from_paintable (drag, paintable, 0, 0); g_object_unref (paintable); } text_view->priv->drag = drag; g_object_unref (drag); } static void gtk_text_view_drag_leave (GtkDropTarget *dest, GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; gtk_text_mark_set_visible (priv->dnd_mark, FALSE); } static GdkDragAction gtk_text_view_drag_motion (GtkDropTarget *dest, double x, double y, GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GtkTextIter newplace; GtkTextIter start; GtkTextIter end; int bx, by; gboolean can_accept = FALSE; gtk_text_view_window_to_buffer_coords (text_view, GTK_TEXT_WINDOW_WIDGET, x, y, &bx, &by); gtk_text_layout_get_iter_at_pixel (priv->layout, &newplace, bx, by); if (gtk_text_buffer_get_selection_bounds (get_buffer (text_view), &start, &end) && gtk_text_iter_compare (&newplace, &start) >= 0 && gtk_text_iter_compare (&newplace, &end) <= 0) { /* We're inside the selection. */ } else { can_accept = gtk_text_iter_can_insert (&newplace, priv->editable); } if (can_accept) { gtk_text_mark_set_visible (priv->dnd_mark, cursor_visible (text_view)); if (text_view->priv->drag) return GDK_ACTION_MOVE; else return GDK_ACTION_COPY; } else { gtk_text_mark_set_visible (priv->dnd_mark, FALSE); return 0; } } static gboolean gtk_text_view_drag_drop (GtkDropTarget *dest, const GValue *value, double x, double y, GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GtkTextBuffer *buffer; GtkTextIter drop_point; buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &drop_point, priv->dnd_mark); if (!gtk_text_iter_can_insert (&drop_point, priv->editable)) return FALSE; gtk_text_buffer_begin_user_action (buffer); if (!gtk_text_buffer_insert_interactive (buffer, &drop_point, (char *) g_value_get_string (value), -1, text_view->priv->editable)) gtk_widget_error_bell (GTK_WIDGET (text_view)); gtk_text_buffer_get_iter_at_mark (buffer, &drop_point, priv->dnd_mark); gtk_text_buffer_place_cursor (buffer, &drop_point); gtk_text_buffer_end_user_action (buffer); return TRUE; } static void gtk_text_view_set_hadjustment (GtkTextView *text_view, GtkAdjustment *adjustment) { GtkTextViewPrivate *priv = text_view->priv; if (adjustment && priv->hadjustment == adjustment) return; if (priv->hadjustment != NULL) { g_signal_handlers_disconnect_by_func (priv->hadjustment, gtk_text_view_value_changed, text_view); g_object_unref (priv->hadjustment); } if (adjustment == NULL) adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0); g_signal_connect (adjustment, "value-changed", G_CALLBACK (gtk_text_view_value_changed), text_view); priv->hadjustment = g_object_ref_sink (adjustment); gtk_text_view_set_hadjustment_values (text_view); g_object_notify (G_OBJECT (text_view), "hadjustment"); } static void gtk_text_view_set_vadjustment (GtkTextView *text_view, GtkAdjustment *adjustment) { GtkTextViewPrivate *priv = text_view->priv; if (adjustment && priv->vadjustment == adjustment) return; if (priv->vadjustment != NULL) { g_signal_handlers_disconnect_by_func (priv->vadjustment, gtk_text_view_value_changed, text_view); g_object_unref (priv->vadjustment); } if (adjustment == NULL) adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0); g_signal_connect (adjustment, "value-changed", G_CALLBACK (gtk_text_view_value_changed), text_view); priv->vadjustment = g_object_ref_sink (adjustment); gtk_text_view_set_vadjustment_values (text_view); g_object_notify (G_OBJECT (text_view), "vadjustment"); } static void gtk_text_view_set_hadjustment_values (GtkTextView *text_view) { GtkTextViewPrivate *priv; int screen_width; double old_value; double new_value; double new_upper; priv = text_view->priv; screen_width = SCREEN_WIDTH (text_view); old_value = gtk_adjustment_get_value (priv->hadjustment); new_upper = MAX (screen_width, priv->width); g_object_set (priv->hadjustment, "lower", 0.0, "upper", new_upper, "page-size", (double)screen_width, "step-increment", screen_width * 0.1, "page-increment", screen_width * 0.9, NULL); new_value = CLAMP (old_value, 0, new_upper - screen_width); if (new_value != old_value) gtk_adjustment_set_value (priv->hadjustment, new_value); } static void gtk_text_view_set_vadjustment_values (GtkTextView *text_view) { GtkTextViewPrivate *priv; GtkTextIter first_para; int screen_height; int y; double old_value; double new_value; double new_upper; priv = text_view->priv; screen_height = SCREEN_HEIGHT (text_view); old_value = gtk_adjustment_get_value (priv->vadjustment); new_upper = MAX (screen_height, priv->height); g_object_set (priv->vadjustment, "lower", 0.0, "upper", new_upper, "page-size", (double)screen_height, "step-increment", screen_height * 0.1, "page-increment", screen_height * 0.9, NULL); /* Now adjust the value of the adjustment to keep the cursor at the * same place in the buffer */ gtk_text_view_ensure_layout (text_view); gtk_text_view_get_first_para_iter (text_view, &first_para); gtk_text_layout_get_line_yrange (priv->layout, &first_para, &y, NULL); y += priv->first_para_pixels; new_value = CLAMP (y, 0, new_upper - screen_height); if (new_value != old_value) gtk_adjustment_set_value (priv->vadjustment, new_value); } static void gtk_text_view_value_changed (GtkAdjustment *adjustment, GtkTextView *text_view) { GtkTextViewPrivate *priv; GtkTextIter iter; int line_top; int dx = 0; int dy = 0; priv = text_view->priv; /* Note that we oddly call this function with adjustment == NULL * sometimes */ priv->onscreen_validated = FALSE; DV(g_print(">Scroll offset changed %s/%g, onscreen_validated = FALSE ("G_STRLOC")\n", adjustment == priv->hadjustment ? "hadjustment" : adjustment == priv->vadjustment ? "vadjustment" : "none", adjustment ? gtk_adjustment_get_value (adjustment) : 0.0)); if (adjustment == priv->hadjustment) { dx = priv->xoffset - (int)gtk_adjustment_get_value (adjustment); priv->xoffset = (int)gtk_adjustment_get_value (adjustment) - priv->left_padding; } else if (adjustment == priv->vadjustment) { dy = priv->yoffset - (int)gtk_adjustment_get_value (adjustment) + priv->top_margin ; priv->yoffset -= dy; if (priv->layout) { gtk_text_layout_get_line_at_y (priv->layout, &iter, gtk_adjustment_get_value (adjustment), &line_top); gtk_text_buffer_move_mark (get_buffer (text_view), priv->first_para_mark, &iter); priv->first_para_pixels = gtk_adjustment_get_value (adjustment) - line_top; } } if (dx != 0 || dy != 0) { if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { if (priv->selection_bubble) gtk_widget_hide (priv->selection_bubble); } } /* This could result in invalidation, which would install the * first_validate_idle, which would validate onscreen; * but we're going to go ahead and validate here, so * first_validate_idle shouldn't have anything to do. */ gtk_text_view_update_layout_width (text_view); /* We also update the IM spot location here, since the IM context * might do something that leads to validation. */ gtk_text_view_update_im_spot_location (text_view); /* note that validation of onscreen could invoke this function * recursively, by scrolling to maintain first_para, or in response * to updating the layout width, however there is no problem with * that, or shouldn't be. */ gtk_text_view_validate_onscreen (text_view); /* If this got installed, get rid of it, it's just a waste of time. */ if (priv->first_validate_idle != 0) { g_source_remove (priv->first_validate_idle); priv->first_validate_idle = 0; } /* Allow to extend selection with mouse scrollwheel. Bug 710612 */ if (gtk_gesture_is_active (priv->drag_gesture)) { GdkEvent *current_event; current_event = gtk_event_controller_get_current_event (GTK_EVENT_CONTROLLER (priv->drag_gesture)); if (current_event != NULL) { if (gdk_event_get_event_type (current_event) == GDK_SCROLL) move_mark_to_pointer_and_scroll (text_view, "insert"); } } /* Finally we update the IM cursor location again, to ensure any * changes made by the validation are pushed through. */ gtk_text_view_update_im_spot_location (text_view); gtk_text_view_update_handles (text_view); if (priv->anchored_children.length > 0) gtk_widget_queue_allocate (GTK_WIDGET (text_view)); else gtk_widget_queue_draw (GTK_WIDGET (text_view)); DV(g_print(">End scroll offset changed handler ("G_STRLOC")\n")); } static void gtk_text_view_commit_handler (GtkIMContext *context, const char *str, GtkTextView *text_view) { gtk_text_view_commit_text (text_view, str); gtk_text_view_reset_blink_time (text_view); gtk_text_view_pend_cursor_blink (text_view); } static void gtk_text_view_commit_text (GtkTextView *text_view, const char *str) { GtkTextViewPrivate *priv; gboolean had_selection; priv = text_view->priv; gtk_text_view_obscure_mouse_cursor (text_view); gtk_text_buffer_begin_user_action (get_buffer (text_view)); had_selection = gtk_text_buffer_get_selection_bounds (get_buffer (text_view), NULL, NULL); gtk_text_buffer_delete_selection (get_buffer (text_view), TRUE, priv->editable); if (!strcmp (str, "\n")) { if (!gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), "\n", 1, priv->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } else { if (!had_selection && priv->overwrite_mode) { GtkTextIter insert; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); if (!gtk_text_iter_ends_line (&insert)) gtk_text_view_delete_from_cursor (text_view, GTK_DELETE_CHARS, 1); } if (!gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), str, -1, priv->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } gtk_text_buffer_end_user_action (get_buffer (text_view)); gtk_text_view_set_virtual_cursor_pos (text_view, -1, -1); DV(g_print (G_STRLOC": scrolling onscreen\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); } static void gtk_text_view_preedit_changed_handler (GtkIMContext *context, GtkTextView *text_view) { GtkTextViewPrivate *priv; char *str; PangoAttrList *attrs; int cursor_pos; GtkTextIter iter; priv = text_view->priv; gtk_text_view_obscure_mouse_cursor (text_view); gtk_text_buffer_get_iter_at_mark (priv->buffer, &iter, gtk_text_buffer_get_insert (priv->buffer)); /* Keypress events are passed to input method even if cursor position is * not editable; so beep here if it's multi-key input sequence, input * method will be reset in when the event is handled by GTK+. */ gtk_im_context_get_preedit_string (context, &str, &attrs, &cursor_pos); if (str && str[0] && !gtk_text_iter_can_insert (&iter, priv->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); goto out; } g_signal_emit (text_view, signals[PREEDIT_CHANGED], 0, str); if (priv->layout) gtk_text_layout_set_preedit_string (priv->layout, str, attrs, cursor_pos); if (gtk_widget_has_focus (GTK_WIDGET (text_view))) gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); out: pango_attr_list_unref (attrs); g_free (str); } static gboolean gtk_text_view_retrieve_surrounding_handler (GtkIMContext *context, GtkTextView *text_view) { GtkTextIter start; GtkTextIter end; int pos; char *text; gtk_text_buffer_get_iter_at_mark (text_view->priv->buffer, &start, gtk_text_buffer_get_insert (text_view->priv->buffer)); end = start; pos = gtk_text_iter_get_line_index (&start); gtk_text_iter_set_line_offset (&start, 0); gtk_text_iter_forward_to_line_end (&end); text = gtk_text_iter_get_slice (&start, &end); gtk_im_context_set_surrounding (context, text, -1, pos); g_free (text); return TRUE; } static gboolean gtk_text_view_delete_surrounding_handler (GtkIMContext *context, int offset, int n_chars, GtkTextView *text_view) { GtkTextViewPrivate *priv; GtkTextIter start; GtkTextIter end; priv = text_view->priv; gtk_text_buffer_get_iter_at_mark (priv->buffer, &start, gtk_text_buffer_get_insert (priv->buffer)); end = start; gtk_text_iter_forward_chars (&start, offset); gtk_text_iter_forward_chars (&end, offset + n_chars); gtk_text_buffer_delete_interactive (priv->buffer, &start, &end, priv->editable); return TRUE; } static void gtk_text_view_mark_set_handler (GtkTextBuffer *buffer, const GtkTextIter *location, GtkTextMark *mark, gpointer data) { GtkTextView *text_view = GTK_TEXT_VIEW (data); gboolean need_reset = FALSE; gboolean has_selection; if (mark == gtk_text_buffer_get_insert (buffer)) { text_view->priv->virtual_cursor_x = -1; text_view->priv->virtual_cursor_y = -1; gtk_text_view_update_im_spot_location (text_view); need_reset = TRUE; } else if (mark == gtk_text_buffer_get_selection_bound (buffer)) { need_reset = TRUE; } if (need_reset) { gtk_text_view_reset_im_context (text_view); gtk_text_view_update_handles (text_view); has_selection = gtk_text_buffer_get_selection_bounds (get_buffer (text_view), NULL, NULL); gtk_css_node_set_visible (text_view->priv->selection_node, has_selection); } } static void gtk_text_view_get_virtual_cursor_pos (GtkTextView *text_view, GtkTextIter *cursor, int *x, int *y) { GtkTextViewPrivate *priv; GtkTextIter insert; GdkRectangle pos; priv = text_view->priv; if (cursor) insert = *cursor; else gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &insert, gtk_text_buffer_get_insert (get_buffer (text_view))); if ((x && priv->virtual_cursor_x == -1) || (y && priv->virtual_cursor_y == -1)) gtk_text_layout_get_cursor_locations (priv->layout, &insert, &pos, NULL); if (x) { if (priv->virtual_cursor_x != -1) *x = priv->virtual_cursor_x; else *x = pos.x; } if (y) { if (priv->virtual_cursor_y != -1) *y = priv->virtual_cursor_y; else *y = pos.y + pos.height / 2; } } static void gtk_text_view_set_virtual_cursor_pos (GtkTextView *text_view, int x, int y) { GdkRectangle pos; if (!text_view->priv->layout) return; if (x == -1 || y == -1) gtk_text_view_get_cursor_locations (text_view, NULL, &pos, NULL); text_view->priv->virtual_cursor_x = (x == -1) ? pos.x : x; text_view->priv->virtual_cursor_y = (y == -1) ? pos.y + pos.height / 2 : y; } static void hide_selection_bubble (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; if (priv->selection_bubble && gtk_widget_get_visible (priv->selection_bubble)) gtk_widget_hide (priv->selection_bubble); } static void gtk_text_view_select_all (GtkWidget *widget, gboolean select) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextBuffer *buffer; GtkTextIter start_iter, end_iter, insert; buffer = text_view->priv->buffer; if (select) { gtk_text_buffer_get_bounds (buffer, &start_iter, &end_iter); gtk_text_buffer_select_range (buffer, &start_iter, &end_iter); } else { gtk_text_buffer_get_iter_at_mark (buffer, &insert, gtk_text_buffer_get_insert (buffer)); gtk_text_buffer_move_mark_by_name (buffer, "selection_bound", &insert); } } static gboolean range_contains_editable_text (const GtkTextIter *start, const GtkTextIter *end, gboolean default_editability) { GtkTextIter iter = *start; while (gtk_text_iter_compare (&iter, end) < 0) { if (gtk_text_iter_editable (&iter, default_editability)) return TRUE; gtk_text_iter_forward_to_tag_toggle (&iter, NULL); } return FALSE; } static void gtk_text_view_activate_clipboard_cut (GtkWidget *widget, const char *action_name, GVariant *parameter) { GtkTextView *self = GTK_TEXT_VIEW (widget); g_signal_emit_by_name (self, "cut-clipboard"); hide_selection_bubble (self); } static void gtk_text_view_activate_clipboard_copy (GtkWidget *widget, const char *action_name, GVariant *parameter) { GtkTextView *self = GTK_TEXT_VIEW (widget); g_signal_emit_by_name (self, "copy-clipboard"); hide_selection_bubble (self); } static void gtk_text_view_activate_clipboard_paste (GtkWidget *widget, const char *action_name, GVariant *parameter) { GtkTextView *self = GTK_TEXT_VIEW (widget); g_signal_emit_by_name (self, "paste-clipboard"); hide_selection_bubble (self); } static void gtk_text_view_activate_selection_select_all (GtkWidget *widget, const char *action_name, GVariant *parameter) { gtk_text_view_select_all (widget, TRUE); } static void gtk_text_view_activate_selection_delete (GtkWidget *widget, const char *action_name, GVariant *parameter) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); gtk_text_buffer_delete_selection (get_buffer (text_view), TRUE, text_view->priv->editable); } static void gtk_text_view_activate_misc_insert_emoji (GtkWidget *widget, const char *action_name, GVariant *parameter) { gtk_text_view_insert_emoji (GTK_TEXT_VIEW (widget)); } static void gtk_text_view_update_clipboard_actions (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GdkClipboard *clipboard; gboolean have_selection; gboolean can_paste, can_insert; GtkTextIter iter, sel_start, sel_end; clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view)); can_paste = gdk_content_formats_contain_gtype (gdk_clipboard_get_formats (clipboard), G_TYPE_STRING); have_selection = gtk_text_buffer_get_selection_bounds (get_buffer (text_view), &sel_start, &sel_end); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, gtk_text_buffer_get_insert (get_buffer (text_view))); can_insert = gtk_text_iter_can_insert (&iter, priv->editable); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "clipboard.cut", have_selection && range_contains_editable_text (&sel_start, &sel_end, priv->editable)); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "clipboard.copy", have_selection); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "clipboard.paste", can_insert && can_paste); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "selection.delete", have_selection && range_contains_editable_text (&sel_start, &sel_end, priv->editable)); gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "selection.select-all", gtk_text_buffer_get_char_count (priv->buffer) > 0); } static void gtk_text_view_update_emoji_action (GtkTextView *text_view) { gtk_widget_action_set_enabled (GTK_WIDGET (text_view), "misc.insert-emoji", (gtk_text_view_get_input_hints (text_view) & GTK_INPUT_HINT_NO_EMOJI) == 0 && text_view->priv->editable); } static GMenuModel * gtk_text_view_get_menu_model (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; GMenu *menu, *section; GMenuItem *item; menu = g_menu_new (); section = g_menu_new (); item = g_menu_item_new (_("Cu_t"), "clipboard.cut"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-cut-symbolic"); g_menu_append_item (section, item); g_object_unref (item); item = g_menu_item_new (_("_Copy"), "clipboard.copy"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-copy-symbolic"); g_menu_append_item (section, item); g_object_unref (item); item = g_menu_item_new (_("_Paste"), "clipboard.paste"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-paste-symbolic"); g_menu_append_item (section, item); g_object_unref (item); item = g_menu_item_new (_("_Delete"), "selection.delete"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-delete-symbolic"); g_menu_append_item (section, item); g_object_unref (item); g_menu_append_section (menu, NULL, G_MENU_MODEL (section)); g_object_unref (section); section = g_menu_new (); item = g_menu_item_new (_("_Undo"), "text.undo"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-undo-symbolic"); g_menu_append_item (section, item); g_object_unref (item); item = g_menu_item_new (_("_Redo"), "text.redo"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-redo-symbolic"); g_menu_append_item (section, item); g_object_unref (item); g_menu_append_section (menu, NULL, G_MENU_MODEL (section)); g_object_unref (section); section = g_menu_new (); item = g_menu_item_new (_("Select _All"), "selection.select-all"); g_menu_item_set_attribute (item, "touch-icon", "s", "edit-select-all-symbolic"); g_menu_append_item (section, item); g_object_unref (item); item = g_menu_item_new ( _("Insert _Emoji"), "misc.insert-emoji"); g_menu_item_set_attribute (item, "hidden-when", "s", "action-disabled"); g_menu_item_set_attribute (item, "touch-icon", "s", "face-smile-symbolic"); g_menu_append_item (section, item); g_object_unref (item); g_menu_append_section (menu, NULL, G_MENU_MODEL (section)); g_object_unref (section); if (priv->extra_menu) g_menu_append_section (menu, NULL, priv->extra_menu); return G_MENU_MODEL (menu); } static void gtk_text_view_do_popup (GtkTextView *text_view, GdkEvent *trigger_event) { GtkTextViewPrivate *priv = text_view->priv; if (!gtk_widget_get_realized (GTK_WIDGET (text_view))) return; gtk_text_view_update_clipboard_actions (text_view); if (!priv->popup_menu) { GMenuModel *model; model = gtk_text_view_get_menu_model (text_view); priv->popup_menu = gtk_popover_menu_new_from_model (model); gtk_css_node_insert_after (gtk_widget_get_css_node (GTK_WIDGET (text_view)), gtk_widget_get_css_node (priv->popup_menu), priv->text_window->css_node); gtk_widget_set_parent (priv->popup_menu, GTK_WIDGET (text_view)); gtk_popover_set_position (GTK_POPOVER (priv->popup_menu), GTK_POS_BOTTOM); gtk_popover_set_has_arrow (GTK_POPOVER (priv->popup_menu), FALSE); gtk_widget_set_halign (priv->popup_menu, GTK_ALIGN_START); g_object_unref (model); } if (trigger_event && gdk_event_triggers_context_menu (trigger_event)) { GdkDevice *device; GdkSeat *seat; GdkRectangle rect = { 0, 0, 1, 1 }; device = gdk_event_get_device (trigger_event); seat = gdk_event_get_seat (trigger_event); if (device == gdk_seat_get_keyboard (seat)) device = gdk_seat_get_pointer (seat); if (device) { GtkNative *native; GdkSurface *surface; double px, py; double nx, ny; native = gtk_widget_get_native (GTK_WIDGET (text_view)); surface = gtk_native_get_surface (native); gdk_surface_get_device_position (surface, device, &px, &py, NULL); gtk_native_get_surface_transform (native, &nx, &ny); gtk_widget_translate_coordinates (GTK_WIDGET (gtk_widget_get_native (GTK_WIDGET (text_view))), GTK_WIDGET (text_view), px - nx, py - ny, &px, &py); rect.x = px; rect.y = py; } gtk_popover_set_pointing_to (GTK_POPOVER (priv->popup_menu), &rect); } else { GtkTextIter iter; GdkRectangle iter_location; GdkRectangle visible_rect; gboolean is_visible; gtk_text_view_get_iter_location (text_view, &iter, &iter_location); gtk_text_view_get_visible_rect (text_view, &visible_rect); is_visible = (iter_location.x + iter_location.width > visible_rect.x && iter_location.x < visible_rect.x + visible_rect.width && iter_location.y + iter_location.height > visible_rect.y && iter_location.y < visible_rect.y + visible_rect.height); if (is_visible) { gtk_text_view_buffer_to_window_coords (text_view, GTK_TEXT_WINDOW_WIDGET, iter_location.x, iter_location.y, &iter_location.x, &iter_location.y); gtk_popover_set_pointing_to (GTK_POPOVER (priv->popup_menu), &iter_location); } } gtk_popover_popup (GTK_POPOVER (priv->popup_menu)); } static void gtk_text_view_popup_menu (GtkWidget *widget, const char *action_name, GVariant *parameters) { gtk_text_view_do_popup (GTK_TEXT_VIEW (widget), NULL); } static void gtk_text_view_get_selection_rect (GtkTextView *text_view, cairo_rectangle_int_t *rect) { cairo_rectangle_int_t rect_cursor, rect_bound; GtkTextIter cursor, bound; GtkTextBuffer *buffer; int x1, y1, x2, y2; buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &cursor, gtk_text_buffer_get_insert (buffer)); gtk_text_buffer_get_iter_at_mark (buffer, &bound, gtk_text_buffer_get_selection_bound (buffer)); gtk_text_view_get_cursor_locations (text_view, &cursor, &rect_cursor, NULL); gtk_text_view_get_cursor_locations (text_view, &bound, &rect_bound, NULL); x1 = MIN (rect_cursor.x, rect_bound.x); x2 = MAX (rect_cursor.x, rect_bound.x); y1 = MIN (rect_cursor.y, rect_bound.y); y2 = MAX (rect_cursor.y + rect_cursor.height, rect_bound.y + rect_bound.height); rect->x = x1; rect->y = y1; rect->width = x2 - x1; rect->height = y2 - y1; } static void show_or_hide_handles (GtkWidget *popover, GParamSpec *pspec, GtkTextView *text_view) { gboolean visible; visible = gtk_widget_get_visible (popover); text_view->priv->text_handles_enabled = !visible; gtk_text_view_update_handles (text_view); } static void append_bubble_item (GtkTextView *text_view, GtkWidget *toolbar, GMenuModel *model, int index) { GtkWidget *item, *image; GVariant *att; const char *icon_name; const char *action_name; GMenuModel *link; gboolean is_toggle_action = FALSE; GtkActionMuxer *muxer; gboolean enabled; const GVariantType *param_type; const GVariantType *state_type; link = g_menu_model_get_item_link (model, index, "section"); if (link) { int i; for (i = 0; i < g_menu_model_get_n_items (link); i++) append_bubble_item (text_view, toolbar, link, i); g_object_unref (link); return; } att = g_menu_model_get_item_attribute_value (model, index, "touch-icon", G_VARIANT_TYPE_STRING); if (att == NULL) return; icon_name = g_variant_get_string (att, NULL); g_variant_unref (att); att = g_menu_model_get_item_attribute_value (model, index, "action", G_VARIANT_TYPE_STRING); if (att == NULL) return; action_name = g_variant_get_string (att, NULL); g_variant_unref (att); muxer = _gtk_widget_get_action_muxer (GTK_WIDGET (text_view), FALSE); if (muxer) { gtk_action_muxer_query_action (muxer, action_name, &enabled, ¶m_type, &state_type, NULL, NULL); if (!enabled) return; if (param_type == NULL && state_type != NULL && g_variant_type_equal (state_type, G_VARIANT_TYPE_BOOLEAN)) is_toggle_action = TRUE; } if (is_toggle_action) item = gtk_toggle_button_new (); else item = gtk_button_new (); gtk_widget_set_focus_on_click (item, FALSE); image = gtk_image_new_from_icon_name (icon_name); gtk_button_set_child (GTK_BUTTON (item), image); gtk_widget_add_css_class (item, "image-button"); gtk_actionable_set_action_name (GTK_ACTIONABLE (item), action_name); gtk_box_append (GTK_BOX (toolbar), item); } static gboolean gtk_text_view_selection_bubble_popup_show (gpointer user_data) { GtkTextView *text_view = user_data; GtkTextViewPrivate *priv = text_view->priv; cairo_rectangle_int_t rect; GtkWidget *box; GtkWidget *toolbar; GMenuModel *model; int i; gtk_text_view_update_clipboard_actions (text_view); priv->selection_bubble_timeout_id = 0; g_clear_pointer (&priv->selection_bubble, gtk_widget_unparent); priv->selection_bubble = gtk_popover_new (); gtk_widget_set_parent (priv->selection_bubble, GTK_WIDGET (text_view)); gtk_widget_add_css_class (priv->selection_bubble, "touch-selection"); gtk_popover_set_position (GTK_POPOVER (priv->selection_bubble), GTK_POS_BOTTOM); gtk_popover_set_autohide (GTK_POPOVER (priv->selection_bubble), FALSE); g_signal_connect (priv->selection_bubble, "notify::visible", G_CALLBACK (show_or_hide_handles), text_view); box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 5); gtk_widget_set_margin_start (box, 10); gtk_widget_set_margin_end (box, 10); gtk_widget_set_margin_top (box, 10); gtk_widget_set_margin_bottom (box, 10); toolbar = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0); gtk_widget_add_css_class (toolbar, "linked"); gtk_popover_set_child (GTK_POPOVER (priv->selection_bubble), box); gtk_box_append (GTK_BOX (box), toolbar); model = gtk_text_view_get_menu_model (text_view); for (i = 0; i < g_menu_model_get_n_items (model); i++) append_bubble_item (text_view, toolbar, model, i); g_object_unref (model); gtk_text_view_get_selection_rect (text_view, &rect); rect.x -= priv->xoffset; rect.y -= priv->yoffset; _text_window_to_widget_coords (text_view, &rect.x, &rect.y); rect.x -= 5; rect.y -= 5; rect.width += 10; rect.height += 10; gtk_popover_set_pointing_to (GTK_POPOVER (priv->selection_bubble), &rect); gtk_widget_show (priv->selection_bubble); return G_SOURCE_REMOVE; } static void gtk_text_view_selection_bubble_popup_unset (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = text_view->priv; if (priv->selection_bubble) gtk_widget_hide (priv->selection_bubble); if (priv->selection_bubble_timeout_id) { g_source_remove (priv->selection_bubble_timeout_id); priv->selection_bubble_timeout_id = 0; } } static void gtk_text_view_selection_bubble_popup_set (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = text_view->priv; if (priv->selection_bubble_timeout_id) g_source_remove (priv->selection_bubble_timeout_id); priv->selection_bubble_timeout_id = g_timeout_add (50, gtk_text_view_selection_bubble_popup_show, text_view); g_source_set_name_by_id (priv->selection_bubble_timeout_id, "[gtk] gtk_text_view_selection_bubble_popup_cb"); } /* Child GdkSurfaces */ static void node_style_changed_cb (GtkCssNode *node, GtkCssStyleChange *change, GtkWidget *widget) { if (gtk_css_style_change_affects (change, GTK_CSS_AFFECTS_SIZE)) gtk_widget_queue_resize (widget); else gtk_widget_queue_draw (widget); } static void update_node_ordering (GtkWidget *widget) { GtkTextViewPrivate *priv = GTK_TEXT_VIEW (widget)->priv; GtkCssNode *widget_node, *sibling, *child_node; if (priv->text_window == NULL) return; widget_node = gtk_widget_get_css_node (widget); sibling = priv->text_window->css_node; if (priv->left_child) { child_node = gtk_widget_get_css_node (GTK_WIDGET (priv->left_child)); gtk_css_node_insert_before (widget_node, child_node, sibling); sibling = child_node; } if (priv->top_child) { child_node = gtk_widget_get_css_node (GTK_WIDGET (priv->top_child)); gtk_css_node_insert_before (widget_node, child_node, sibling); } sibling = priv->text_window->css_node; if (priv->right_child) { child_node = gtk_widget_get_css_node (GTK_WIDGET (priv->right_child)); gtk_css_node_insert_after (widget_node, child_node, sibling); sibling = child_node; } if (priv->bottom_child) { child_node = gtk_widget_get_css_node (GTK_WIDGET (priv->bottom_child)); gtk_css_node_insert_after (widget_node, child_node, sibling); } } static GtkTextWindow* text_window_new (GtkWidget *widget) { GtkTextWindow *win; GtkCssNode *widget_node; win = g_slice_new (GtkTextWindow); win->type = GTK_TEXT_WINDOW_TEXT; win->widget = widget; win->allocation.width = 0; win->allocation.height = 0; win->allocation.x = 0; win->allocation.y = 0; widget_node = gtk_widget_get_css_node (widget); win->css_node = gtk_css_node_new (); gtk_css_node_set_parent (win->css_node, widget_node); gtk_css_node_set_state (win->css_node, gtk_css_node_get_state (widget_node)); g_signal_connect_object (win->css_node, "style-changed", G_CALLBACK (node_style_changed_cb), widget, 0); gtk_css_node_set_name (win->css_node, g_quark_from_static_string ("text")); g_object_unref (win->css_node); return win; } static void text_window_free (GtkTextWindow *win) { gtk_css_node_set_parent (win->css_node, NULL); g_slice_free (GtkTextWindow, win); } static void text_window_size_allocate (GtkTextWindow *win, GdkRectangle *rect) { win->allocation = *rect; } static int text_window_get_width (GtkTextWindow *win) { return win->allocation.width; } static int text_window_get_height (GtkTextWindow *win) { return win->allocation.height; } /* Windows */ /** * gtk_text_view_buffer_to_window_coords: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType * @buffer_x: buffer x coordinate * @buffer_y: buffer y coordinate * @window_x: (out) (allow-none): window x coordinate return location or %NULL * @window_y: (out) (allow-none): window y coordinate return location or %NULL * * Converts coordinate (@buffer_x, @buffer_y) to coordinates for the window * @win, and stores the result in (@window_x, @window_y). **/ void gtk_text_view_buffer_to_window_coords (GtkTextView *text_view, GtkTextWindowType win, int buffer_x, int buffer_y, int *window_x, int *window_y) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); buffer_x -= priv->xoffset; buffer_y -= priv->yoffset; switch (win) { case GTK_TEXT_WINDOW_WIDGET: buffer_x += priv->border_window_size.left; buffer_y += priv->border_window_size.top; break; case GTK_TEXT_WINDOW_TEXT: break; case GTK_TEXT_WINDOW_LEFT: buffer_x += priv->border_window_size.left; break; case GTK_TEXT_WINDOW_RIGHT: buffer_x -= text_window_get_width (priv->text_window); break; case GTK_TEXT_WINDOW_TOP: buffer_y += priv->border_window_size.top; break; case GTK_TEXT_WINDOW_BOTTOM: buffer_y -= text_window_get_height (priv->text_window); break; default: g_warning ("%s: Unknown GtkTextWindowType", G_STRFUNC); break; } if (window_x) *window_x = buffer_x; if (window_y) *window_y = buffer_y; } /** * gtk_text_view_window_to_buffer_coords: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType * @window_x: window x coordinate * @window_y: window y coordinate * @buffer_x: (out) (allow-none): buffer x coordinate return location or %NULL * @buffer_y: (out) (allow-none): buffer y coordinate return location or %NULL * * Converts coordinates on the window identified by @win to buffer * coordinates, storing the result in (@buffer_x,@buffer_y). **/ void gtk_text_view_window_to_buffer_coords (GtkTextView *text_view, GtkTextWindowType win, int window_x, int window_y, int *buffer_x, int *buffer_y) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); switch (win) { case GTK_TEXT_WINDOW_WIDGET: window_x -= priv->border_window_size.left; window_y -= priv->border_window_size.top; break; case GTK_TEXT_WINDOW_TEXT: break; case GTK_TEXT_WINDOW_LEFT: window_x -= priv->border_window_size.left; break; case GTK_TEXT_WINDOW_RIGHT: window_x += text_window_get_width (priv->text_window); break; case GTK_TEXT_WINDOW_TOP: window_y -= priv->border_window_size.top; break; case GTK_TEXT_WINDOW_BOTTOM: window_y += text_window_get_height (priv->text_window); break; default: g_warning ("%s: Unknown GtkTextWindowType", G_STRFUNC); break; } if (buffer_x) *buffer_x = window_x + priv->xoffset; if (buffer_y) *buffer_y = window_y + priv->yoffset; } /* * Child widgets */ static AnchoredChild * anchored_child_new (GtkWidget *child, GtkTextChildAnchor *anchor, GtkTextLayout *layout) { AnchoredChild *vc; vc = g_slice_new0 (AnchoredChild); vc->link.data = vc; vc->widget = g_object_ref (child); vc->anchor = g_object_ref (anchor); vc->from_top_of_line = 0; vc->from_left_of_buffer = 0; g_object_set_qdata (G_OBJECT (child), quark_text_view_child, vc); gtk_text_child_anchor_register_child (anchor, child, layout); return vc; } static void anchored_child_free (AnchoredChild *child) { g_assert (child->link.prev == NULL); g_assert (child->link.next == NULL); g_object_set_qdata (G_OBJECT (child->widget), quark_text_view_child, NULL); gtk_text_child_anchor_unregister_child (child->anchor, child->widget); g_object_unref (child->anchor); g_object_unref (child->widget); g_slice_free (AnchoredChild, child); } static void add_child (GtkTextView *text_view, AnchoredChild *vc) { GtkTextViewPrivate *priv = text_view->priv; g_queue_push_head_link (&priv->anchored_children, &vc->link); gtk_css_node_set_parent (gtk_widget_get_css_node (vc->widget), priv->text_window->css_node); gtk_widget_set_parent (vc->widget, GTK_WIDGET (text_view)); } /** * gtk_text_view_add_child_at_anchor: * @text_view: a #GtkTextView * @child: a #GtkWidget * @anchor: a #GtkTextChildAnchor in the #GtkTextBuffer for @text_view * * Adds a child widget in the text buffer, at the given @anchor. **/ void gtk_text_view_add_child_at_anchor (GtkTextView *text_view, GtkWidget *child, GtkTextChildAnchor *anchor) { AnchoredChild *vc; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_WIDGET (child)); g_return_if_fail (GTK_IS_TEXT_CHILD_ANCHOR (anchor)); g_return_if_fail (gtk_widget_get_parent (child) == NULL); gtk_text_view_ensure_layout (text_view); vc = anchored_child_new (child, anchor, text_view->priv->layout); add_child (text_view, vc); g_assert (vc->widget == child); g_assert (gtk_widget_get_parent (child) == GTK_WIDGET (text_view)); } static void ensure_child (GtkTextView *text_view, GtkTextViewChild **child, GtkTextWindowType window_type) { GtkCssNode *css_node; GtkWidget *new_child; if (*child != NULL) return; new_child = gtk_text_view_child_new (window_type); css_node = gtk_widget_get_css_node (new_child); gtk_css_node_set_parent (css_node, gtk_widget_get_css_node (GTK_WIDGET (text_view))); *child = g_object_ref (GTK_TEXT_VIEW_CHILD (new_child)); gtk_widget_set_parent (GTK_WIDGET (new_child), GTK_WIDGET (text_view)); } /** * gtk_text_view_add_overlay: * @text_view: a #GtkTextView * @child: a #GtkWidget * @xpos: X position of child in window coordinates * @ypos: Y position of child in window coordinates * * Adds @child at a fixed coordinate in the #GtkTextView's text window. The * @xpos and @ypos must be in buffer coordinates (see * gtk_text_view_get_iter_location() to convert to buffer coordinates). * * @child will scroll with the text view. * * If instead you want a widget that will not move with the #GtkTextView * contents see #GtkOverlay. */ void gtk_text_view_add_overlay (GtkTextView *text_view, GtkWidget *child, int xpos, int ypos) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_WIDGET (child)); g_return_if_fail (gtk_widget_get_parent (child) == NULL); ensure_child (text_view, &text_view->priv->center_child, GTK_TEXT_WINDOW_TEXT); gtk_text_view_child_add_overlay (text_view->priv->center_child, child, xpos, ypos); } /** * gtk_text_view_move_overlay: * @text_view: a #GtkTextView * @child: a widget already added with gtk_text_view_add_overlay() * @xpos: new X position in buffer coordinates * @ypos: new Y position in buffer coordinates * * Updates the position of a child, as for gtk_text_view_add_overlay(). **/ void gtk_text_view_move_overlay (GtkTextView *text_view, GtkWidget *child, int xpos, int ypos) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_WIDGET (child)); g_return_if_fail (gtk_widget_get_parent (child) == GTK_WIDGET (text_view)); if (text_view->priv->center_child == NULL) gtk_text_view_child_move_overlay (text_view->priv->center_child, child, xpos, ypos); } /* Iterator operations */ /** * gtk_text_view_forward_display_line: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * * Moves the given @iter forward by one display (wrapped) line. * A display line is different from a paragraph. Paragraphs are * separated by newlines or other paragraph separator characters. * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Returns: %TRUE if @iter was moved and is not on the end iterator **/ gboolean gtk_text_view_forward_display_line (GtkTextView *text_view, GtkTextIter *iter) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_move_iter_to_next_line (text_view->priv->layout, iter); } /** * gtk_text_view_backward_display_line: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * * Moves the given @iter backward by one display (wrapped) line. * A display line is different from a paragraph. Paragraphs are * separated by newlines or other paragraph separator characters. * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Returns: %TRUE if @iter was moved and is not on the end iterator **/ gboolean gtk_text_view_backward_display_line (GtkTextView *text_view, GtkTextIter *iter) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_move_iter_to_previous_line (text_view->priv->layout, iter); } /** * gtk_text_view_forward_display_line_end: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * * Moves the given @iter forward to the next display line end. * A display line is different from a paragraph. Paragraphs are * separated by newlines or other paragraph separator characters. * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Returns: %TRUE if @iter was moved and is not on the end iterator **/ gboolean gtk_text_view_forward_display_line_end (GtkTextView *text_view, GtkTextIter *iter) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_move_iter_to_line_end (text_view->priv->layout, iter, 1); } /** * gtk_text_view_backward_display_line_start: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * * Moves the given @iter backward to the next display line start. * A display line is different from a paragraph. Paragraphs are * separated by newlines or other paragraph separator characters. * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Returns: %TRUE if @iter was moved and is not on the end iterator **/ gboolean gtk_text_view_backward_display_line_start (GtkTextView *text_view, GtkTextIter *iter) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_move_iter_to_line_end (text_view->priv->layout, iter, -1); } /** * gtk_text_view_starts_display_line: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * * Determines whether @iter is at the start of a display line. * See gtk_text_view_forward_display_line() for an explanation of * display lines vs. paragraphs. * * Returns: %TRUE if @iter begins a wrapped line **/ gboolean gtk_text_view_starts_display_line (GtkTextView *text_view, const GtkTextIter *iter) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_iter_starts_line (text_view->priv->layout, iter); } /** * gtk_text_view_move_visually: * @text_view: a #GtkTextView * @iter: a #GtkTextIter * @count: number of characters to move (negative moves left, * positive moves right) * * Move the iterator a given number of characters visually, treating * it as the strong cursor position. If @count is positive, then the * new strong cursor position will be @count positions to the right of * the old cursor position. If @count is negative then the new strong * cursor position will be @count positions to the left of the old * cursor position. * * In the presence of bi-directional text, the correspondence * between logical and visual order will depend on the direction * of the current run, and there may be jumps when the cursor * is moved off of the end of a run. * * Returns: %TRUE if @iter moved and is not on the end iterator **/ gboolean gtk_text_view_move_visually (GtkTextView *text_view, GtkTextIter *iter, int count) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); g_return_val_if_fail (iter != NULL, FALSE); gtk_text_view_ensure_layout (text_view); return gtk_text_layout_move_iter_visually (text_view->priv->layout, iter, count); } /** * gtk_text_view_set_input_purpose: * @text_view: a #GtkTextView * @purpose: the purpose * * Sets the #GtkTextView:input-purpose property which * can be used by on-screen keyboards and other input * methods to adjust their behaviour. */ void gtk_text_view_set_input_purpose (GtkTextView *text_view, GtkInputPurpose purpose) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (gtk_text_view_get_input_purpose (text_view) != purpose) { g_object_set (G_OBJECT (text_view->priv->im_context), "input-purpose", purpose, NULL); g_object_notify (G_OBJECT (text_view), "input-purpose"); } } /** * gtk_text_view_get_input_purpose: * @text_view: a #GtkTextView * * Gets the value of the #GtkTextView:input-purpose property. */ GtkInputPurpose gtk_text_view_get_input_purpose (GtkTextView *text_view) { GtkInputPurpose purpose; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), GTK_INPUT_PURPOSE_FREE_FORM); g_object_get (G_OBJECT (text_view->priv->im_context), "input-purpose", &purpose, NULL); return purpose; } /** * gtk_text_view_set_input_hints: * @text_view: a #GtkTextView * @hints: the hints * * Sets the #GtkTextView:input-hints property, which * allows input methods to fine-tune their behaviour. */ void gtk_text_view_set_input_hints (GtkTextView *text_view, GtkInputHints hints) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (gtk_text_view_get_input_hints (text_view) != hints) { g_object_set (G_OBJECT (text_view->priv->im_context), "input-hints", hints, NULL); g_object_notify (G_OBJECT (text_view), "input-hints"); gtk_text_view_update_emoji_action (text_view); } } /** * gtk_text_view_get_input_hints: * @text_view: a #GtkTextView * * Gets the value of the #GtkTextView:input-hints property. */ GtkInputHints gtk_text_view_get_input_hints (GtkTextView *text_view) { GtkInputHints hints; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), GTK_INPUT_HINT_NONE); g_object_get (G_OBJECT (text_view->priv->im_context), "input-hints", &hints, NULL); return hints; } /** * gtk_text_view_set_monospace: * @text_view: a #GtkTextView * @monospace: %TRUE to request monospace styling * * Sets the #GtkTextView:monospace property, which * indicates that the text view should use monospace * fonts. */ void gtk_text_view_set_monospace (GtkTextView *text_view, gboolean monospace) { gboolean has_monospace; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); has_monospace = gtk_text_view_get_monospace (text_view); if (has_monospace != monospace) { if (monospace) gtk_widget_add_css_class (GTK_WIDGET (text_view), "monospace"); else gtk_widget_remove_css_class (GTK_WIDGET (text_view), "monospace"); g_object_notify (G_OBJECT (text_view), "monospace"); } } /** * gtk_text_view_get_monospace: * @text_view: a #GtkTextView * * Gets the value of the #GtkTextView:monospace property. * * Return: %TRUE if monospace fonts are desired */ gboolean gtk_text_view_get_monospace (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return gtk_widget_has_css_class (GTK_WIDGET (text_view), "monospace"); } static void emoji_picked (GtkEmojiChooser *chooser, const char *text, GtkTextView *self) { GtkTextBuffer *buffer; buffer = get_buffer (self); gtk_text_buffer_begin_user_action (buffer); gtk_text_buffer_delete_selection (buffer, TRUE, TRUE); gtk_text_buffer_insert_at_cursor (buffer, text, -1); gtk_text_buffer_end_user_action (buffer); } static void gtk_text_view_insert_emoji (GtkTextView *text_view) { GtkWidget *chooser; GtkTextIter iter; GdkRectangle rect; GdkRectangle rect2; GtkTextBuffer *buffer; if (gtk_widget_get_ancestor (GTK_WIDGET (text_view), GTK_TYPE_EMOJI_CHOOSER) != NULL) return; chooser = GTK_WIDGET (g_object_get_data (G_OBJECT (text_view), "gtk-emoji-chooser")); if (!chooser) { chooser = gtk_emoji_chooser_new (); g_object_set_data (G_OBJECT (text_view), "gtk-emoji-chooser", chooser); gtk_widget_set_parent (chooser, GTK_WIDGET (text_view)); g_signal_connect (chooser, "emoji-picked", G_CALLBACK (emoji_picked), text_view); g_signal_connect_swapped (chooser, "hide", G_CALLBACK (gtk_widget_grab_focus), text_view); } buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &iter, gtk_text_buffer_get_insert (buffer)); gtk_text_view_get_iter_location (text_view, &iter, (GdkRectangle *) &rect); gtk_text_view_buffer_to_window_coords (text_view, GTK_TEXT_WINDOW_TEXT, rect.x, rect.y, &rect.x, &rect.y); _text_window_to_widget_coords (text_view, &rect.x, &rect.y); gtk_text_view_get_visible_rect (text_view, &rect2); gtk_text_view_buffer_to_window_coords (text_view, GTK_TEXT_WINDOW_TEXT, rect2.x, rect2.y, &rect2.x, &rect2.y); _text_window_to_widget_coords (text_view, &rect2.x, &rect2.y); if (!gdk_rectangle_intersect (&rect2, &rect, &rect)) { rect.x = rect2.width / 2; rect.y = rect2.height / 2; rect.width = 0; rect.height = 0; } gtk_popover_set_pointing_to (GTK_POPOVER (chooser), &rect); gtk_popover_popup (GTK_POPOVER (chooser)); } /** * gtk_text_view_set_extra_menu: * @text_view: a #GtkTextView * @model: (allow-none): a #GMenuModel * * Sets a menu model to add when constructing * the context menu for @text_view. */ void gtk_text_view_set_extra_menu (GtkTextView *text_view, GMenuModel *model) { GtkTextViewPrivate *priv = text_view->priv; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (g_set_object (&priv->extra_menu, model)) { g_clear_pointer (&priv->popup_menu, gtk_widget_unparent); g_object_notify (G_OBJECT (text_view), "extra-menu"); } } /** * gtk_text_view_get_extra_menu: * @text_view: a #GtkTextView * * Gets the menu model set with gtk_text_view_set_extra_menu(). * * Returns: (transfer none): (nullable): the menu model */ GMenuModel * gtk_text_view_get_extra_menu (GtkTextView *text_view) { GtkTextViewPrivate *priv = text_view->priv; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); return priv->extra_menu; } static void gtk_text_view_real_undo (GtkWidget *widget, const char *action_name, GVariant *parameters) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); if (gtk_text_view_get_editable (text_view)) gtk_text_buffer_undo (text_view->priv->buffer); } static void gtk_text_view_real_redo (GtkWidget *widget, const char *action_name, GVariant *parameters) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); if (gtk_text_view_get_editable (text_view)) gtk_text_buffer_redo (text_view->priv->buffer); } static void gtk_text_view_buffer_notify_redo (GtkTextBuffer *buffer, GParamSpec *pspec, GtkTextView *view) { gtk_widget_action_set_enabled (GTK_WIDGET (view), "text.redo", (gtk_text_view_get_editable (view) && gtk_text_buffer_get_can_redo (buffer))); } static void gtk_text_view_buffer_notify_undo (GtkTextBuffer *buffer, GParamSpec *pspec, GtkTextView *view) { gtk_widget_action_set_enabled (GTK_WIDGET (view), "text.undo", (gtk_text_view_get_editable (view) && gtk_text_buffer_get_can_undo (buffer))); }