/* -*- 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, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ /* * 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 #define GTK_TEXT_USE_INTERNAL_UNSUPPORTED_API #include "gtkbindings.h" #include "gtkdnd.h" #include "gtkimagemenuitem.h" #include "gtkintl.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkmenu.h" #include "gtkmenuitem.h" #include "gtkseparatormenuitem.h" #include "gtksettings.h" #include "gtkstock.h" #include "gtktextbufferrichtext.h" #include "gtktextdisplay.h" #include "gtktextview.h" #include "gtkimmulticontext.h" #include "gdk/gdkkeysyms.h" #include "gtkprivate.h" #include "gtktextutil.h" #include "gtkwindow.h" #include "gtkalias.h" /* 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_window_scroll() to reflect the new adjustment value * - validate the lines that were moved onscreen * - gdk_window_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)->text_window) #define SCREEN_HEIGHT(widget) text_window_get_height (GTK_TEXT_VIEW (widget)->text_window) #define SPACE_FOR_CURSOR 1 typedef struct _GtkTextViewPrivate GtkTextViewPrivate; #define GTK_TEXT_VIEW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TEXT_VIEW, GtkTextViewPrivate)) struct _GtkTextViewPrivate { guint blink_time; /* time in msec the cursor has blinked since last user event */ guint im_spot_idle; gchar *im_module; guint scroll_after_paste : 1; }; struct _GtkTextPendingScroll { GtkTextMark *mark; gdouble within_margin; gboolean use_align; gdouble xalign; gdouble yalign; }; enum { SET_SCROLL_ADJUSTMENTS, POPULATE_POPUP, 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, 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_INDENT, PROP_TABS, PROP_CURSOR_VISIBLE, PROP_BUFFER, PROP_OVERWRITE, PROP_ACCEPTS_TAB, PROP_IM_MODULE }; static void gtk_text_view_destroy (GtkObject *object); 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_size_request (GtkWidget *widget, GtkRequisition *requisition); static void gtk_text_view_size_allocate (GtkWidget *widget, GtkAllocation *allocation); static void gtk_text_view_realize (GtkWidget *widget); static void gtk_text_view_unrealize (GtkWidget *widget); static void gtk_text_view_style_set (GtkWidget *widget, GtkStyle *previous_style); static void gtk_text_view_direction_changed (GtkWidget *widget, GtkTextDirection previous_direction); static void gtk_text_view_grab_notify (GtkWidget *widget, gboolean was_grabbed); static void gtk_text_view_state_changed (GtkWidget *widget, GtkStateType previous_state); static gint gtk_text_view_event (GtkWidget *widget, GdkEvent *event); static gint gtk_text_view_key_press_event (GtkWidget *widget, GdkEventKey *event); static gint gtk_text_view_key_release_event (GtkWidget *widget, GdkEventKey *event); static gint gtk_text_view_button_press_event (GtkWidget *widget, GdkEventButton *event); static gint gtk_text_view_button_release_event (GtkWidget *widget, GdkEventButton *event); static gint gtk_text_view_focus_in_event (GtkWidget *widget, GdkEventFocus *event); static gint gtk_text_view_focus_out_event (GtkWidget *widget, GdkEventFocus *event); static gint gtk_text_view_motion_event (GtkWidget *widget, GdkEventMotion *event); static gint gtk_text_view_expose_event (GtkWidget *widget, GdkEventExpose *expose); static void gtk_text_view_draw_focus (GtkWidget *widget); static gboolean gtk_text_view_focus (GtkWidget *widget, GtkDirectionType direction); static void gtk_text_view_move_focus (GtkWidget *widget, GtkDirectionType direction_type); static void gtk_text_view_select_all (GtkWidget *widget, gboolean select); /* Source side drag signals */ static void gtk_text_view_drag_begin (GtkWidget *widget, GdkDragContext *context); static void gtk_text_view_drag_end (GtkWidget *widget, GdkDragContext *context); static void gtk_text_view_drag_data_get (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time); static void gtk_text_view_drag_data_delete (GtkWidget *widget, GdkDragContext *context); /* Target side drag signals */ static void gtk_text_view_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time); static gboolean gtk_text_view_drag_motion (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time); static gboolean gtk_text_view_drag_drop (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time); static void gtk_text_view_drag_data_received (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time); static void gtk_text_view_set_scroll_adjustments (GtkTextView *text_view, GtkAdjustment *hadj, GtkAdjustment *vadj); static gboolean gtk_text_view_popup_menu (GtkWidget *widget); static void gtk_text_view_move_cursor (GtkTextView *text_view, GtkMovementStep step, gint count, gboolean extend_selection); static void gtk_text_view_page_horizontally (GtkTextView *text_view, gint count, gboolean extend_selection); static gboolean gtk_text_view_move_viewport (GtkTextView *text_view, GtkScrollStep step, gint count); static void gtk_text_view_set_anchor (GtkTextView *text_view); static gboolean gtk_text_view_scroll_pages (GtkTextView *text_view, gint count, gboolean extend_selection); static gboolean gtk_text_view_scroll_hpages(GtkTextView *text_view, gint count, gboolean extend_selection); static void gtk_text_view_insert_at_cursor (GtkTextView *text_view, const gchar *str); static void gtk_text_view_delete_from_cursor (GtkTextView *text_view, GtkDeleteType type, gint 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_compat_move_focus(GtkTextView *text_view, GtkDirectionType direction_type); 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, GtkStyle *style); 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, GdkEventButton *event); 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, GdkEventMotion *event); 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 *adj, GtkTextView *view); static void gtk_text_view_commit_handler (GtkIMContext *context, const gchar *str, GtkTextView *text_view); static void gtk_text_view_commit_text (GtkTextView *text_view, const gchar *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, gint offset, gint 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_target_list_notify (GtkTextBuffer *buffer, const GParamSpec *pspec, gpointer data); static void gtk_text_view_paste_done_handler (GtkTextBuffer *buffer, GtkClipboard *clipboard, gpointer data); static void gtk_text_view_get_cursor_location (GtkTextView *text_view, GdkRectangle *pos); static void gtk_text_view_get_virtual_cursor_pos (GtkTextView *text_view, GtkTextIter *cursor, gint *x, gint *y); static void gtk_text_view_set_virtual_cursor_pos (GtkTextView *text_view, gint x, gint y); static GtkAdjustment* get_hadjustment (GtkTextView *text_view); static GtkAdjustment* get_vadjustment (GtkTextView *text_view); static void gtk_text_view_do_popup (GtkTextView *text_view, GdkEventButton *event); static void cancel_pending_scroll (GtkTextView *text_view); static void gtk_text_view_queue_scroll (GtkTextView *text_view, GtkTextMark *mark, gdouble within_margin, gboolean use_align, gdouble xalign, gdouble 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_update_im_spot_location (GtkTextView *text_view); /* Container methods */ static void gtk_text_view_add (GtkContainer *container, GtkWidget *child); static void gtk_text_view_remove (GtkContainer *container, GtkWidget *child); static void gtk_text_view_forall (GtkContainer *container, gboolean include_internals, GtkCallback callback, gpointer callback_data); /* FIXME probably need the focus methods. */ typedef struct _GtkTextViewChild GtkTextViewChild; struct _GtkTextViewChild { GtkWidget *widget; GtkTextChildAnchor *anchor; gint from_top_of_line; gint from_left_of_buffer; /* These are ignored if anchor != NULL */ GtkTextWindowType type; gint x; gint y; }; static GtkTextViewChild* text_view_child_new_anchored (GtkWidget *child, GtkTextChildAnchor *anchor, GtkTextLayout *layout); static GtkTextViewChild* text_view_child_new_window (GtkWidget *child, GtkTextWindowType type, gint x, gint y); static void text_view_child_free (GtkTextViewChild *child); static void text_view_child_set_parent_window (GtkTextView *text_view, GtkTextViewChild *child); struct _GtkTextWindow { GtkTextWindowType type; GtkWidget *widget; GdkWindow *window; GdkWindow *bin_window; GtkRequisition requisition; GdkRectangle allocation; }; static GtkTextWindow *text_window_new (GtkTextWindowType type, GtkWidget *widget, gint width_request, gint height_request); static void text_window_free (GtkTextWindow *win); static void text_window_realize (GtkTextWindow *win, GtkWidget *widget); static void text_window_unrealize (GtkTextWindow *win); static void text_window_size_allocate (GtkTextWindow *win, GdkRectangle *rect); static void text_window_scroll (GtkTextWindow *win, gint dx, gint dy); static void text_window_invalidate_rect (GtkTextWindow *win, GdkRectangle *rect); static void text_window_invalidate_cursors (GtkTextWindow *win); static gint text_window_get_width (GtkTextWindow *win); static gint text_window_get_height (GtkTextWindow *win); static guint signals[LAST_SIGNAL] = { 0 }; G_DEFINE_TYPE (GtkTextView, gtk_text_view, GTK_TYPE_CONTAINER) static void add_move_binding (GtkBindingSet *binding_set, guint keyval, guint modmask, GtkMovementStep step, gint count) { g_assert ((modmask & GDK_SHIFT_MASK) == 0); gtk_binding_entry_add_signal (binding_set, keyval, modmask, "move-cursor", 3, G_TYPE_ENUM, step, G_TYPE_INT, count, G_TYPE_BOOLEAN, FALSE); /* Selection-extending version */ gtk_binding_entry_add_signal (binding_set, keyval, modmask | GDK_SHIFT_MASK, "move-cursor", 3, G_TYPE_ENUM, step, G_TYPE_INT, count, G_TYPE_BOOLEAN, TRUE); } static void gtk_text_view_class_init (GtkTextViewClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkObjectClass *object_class = GTK_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass); GtkBindingSet *binding_set; /* Default handlers and virtual methods */ gobject_class->set_property = gtk_text_view_set_property; gobject_class->get_property = gtk_text_view_get_property; object_class->destroy = gtk_text_view_destroy; gobject_class->finalize = gtk_text_view_finalize; widget_class->realize = gtk_text_view_realize; widget_class->unrealize = gtk_text_view_unrealize; widget_class->style_set = gtk_text_view_style_set; widget_class->direction_changed = gtk_text_view_direction_changed; widget_class->grab_notify = gtk_text_view_grab_notify; widget_class->state_changed = gtk_text_view_state_changed; widget_class->size_request = gtk_text_view_size_request; widget_class->size_allocate = gtk_text_view_size_allocate; widget_class->event = gtk_text_view_event; widget_class->key_press_event = gtk_text_view_key_press_event; widget_class->key_release_event = gtk_text_view_key_release_event; widget_class->button_press_event = gtk_text_view_button_press_event; widget_class->button_release_event = gtk_text_view_button_release_event; widget_class->focus_in_event = gtk_text_view_focus_in_event; widget_class->focus_out_event = gtk_text_view_focus_out_event; widget_class->motion_notify_event = gtk_text_view_motion_event; widget_class->expose_event = gtk_text_view_expose_event; widget_class->focus = gtk_text_view_focus; /* need to override the base class function via override_class_handler, * because the signal slot is not available in GtkWidgetCLass */ g_signal_override_class_handler ("move-focus", GTK_TYPE_TEXT_VIEW, G_CALLBACK (gtk_text_view_move_focus)); widget_class->drag_begin = gtk_text_view_drag_begin; widget_class->drag_end = gtk_text_view_drag_end; widget_class->drag_data_get = gtk_text_view_drag_data_get; widget_class->drag_data_delete = gtk_text_view_drag_data_delete; widget_class->drag_leave = gtk_text_view_drag_leave; widget_class->drag_motion = gtk_text_view_drag_motion; widget_class->drag_drop = gtk_text_view_drag_drop; widget_class->drag_data_received = gtk_text_view_drag_data_received; widget_class->popup_menu = gtk_text_view_popup_menu; container_class->add = gtk_text_view_add; container_class->remove = gtk_text_view_remove; container_class->forall = gtk_text_view_forall; klass->move_cursor = gtk_text_view_move_cursor; klass->page_horizontally = gtk_text_view_page_horizontally; 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->move_focus = gtk_text_view_compat_move_focus; klass->set_scroll_adjustments = gtk_text_view_set_scroll_adjustments; /* * 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_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_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_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_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_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_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_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_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_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_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_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)); /** * GtkTextView:im-module: * * Which IM (input method) module should be used for this entry. * See #GtkIMContext. * * Setting this to a non-%NULL value overrides the * system-wide IM module setting. See the GtkSettings * #GtkSettings:gtk-im-module property. * * Since: 2.16 */ 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)); /* * Style properties */ gtk_widget_class_install_style_property (widget_class, g_param_spec_boxed ("error-underline-color", P_("Error underline color"), P_("Color with which to draw error-indication underlines"), GDK_TYPE_COLOR, GTK_PARAM_READABLE)); /* * 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 * 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 modifer 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); /** * GtkTextView::page-horizontally: * @text_view: the object which received the signal * @count: the number of @step units to move * @extend_selection: %TRUE if the move should extend the selection * * The ::page-horizontally signal is a * keybinding signal * which can be bound to key combinations to allow the user * to initiate horizontal cursor movement by pages. * * This signal should not be used anymore, instead use the * #GtkTextview::move-cursor signal with the #GTK_MOVEMENT_HORIZONTAL_PAGES * granularity. */ signals[PAGE_HORIZONTALLY] = g_signal_new (I_("page-horizontally"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, page_horizontally), NULL, NULL, _gtk_marshal_VOID__INT_BOOLEAN, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_BOOLEAN); /** * GtkTextView::move-viewport: * @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 * * The ::move-viewport signal is a * keybinding signal * 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); /** * GtkTextView::set-anchor: * @text_view: the object which received the signal * * The ::set-anchor signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, 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 * 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, _gtk_marshal_VOID__STRING, 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 * 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 * backwords. */ 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); /** * GtkTextView::backspace: * @text_view: the object which received the signal * * The ::backspace signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkTextView::cut-clipboard: * @text_view: the object which received the signal * * The ::cut-clipboard signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkTextView::copy-clipboard: * @text_view: the object which received the signal * * The ::copy-clipboard signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkTextView::paste-clipboard: * @text_view: the object which received the signal * * The ::paste-clipboard signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkTextView::toggle-overwrite: * @text_view: the object which received the signal * * The ::toggle-overwrite signal is a * keybinding signal * 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, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkTextView::set-scroll-adjustments * @horizontal: the horizontal #GtkAdjustment * @vertical: the vertical #GtkAdjustment * * Set the scroll adjustments for the text view. Usually scrolled containers * like #GtkScrolledWindow will emit this signal to connect two instances * of #GtkScrollbar to the scroll directions of the #GtkTextView. */ signals[SET_SCROLL_ADJUSTMENTS] = g_signal_new (I_("set-scroll-adjustments"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkTextViewClass, set_scroll_adjustments), NULL, NULL, _gtk_marshal_VOID__OBJECT_OBJECT, G_TYPE_NONE, 2, GTK_TYPE_ADJUSTMENT, GTK_TYPE_ADJUSTMENT); widget_class->set_scroll_adjustments_signal = signals[SET_SCROLL_ADJUSTMENTS]; /** * GtkTextView::populate-popup: * @entry: The text view on which the signal is emitted * @menu: the menu that is being populated * * The ::populate-popup signal gets emitted before showing the * context menu of the text view. * * If you need to add items to the context menu, connect * to this signal and append your menuitems to the @menu. */ signals[POPULATE_POPUP] = g_signal_new (I_("populate-popup"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkTextViewClass, populate_popup), NULL, NULL, _gtk_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GTK_TYPE_MENU); /** * 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 * 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 (object_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_CALLBACK (gtk_text_view_select_all), NULL, NULL, _gtk_marshal_VOID__BOOLEAN, 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 * which gets emitted to toggle the visibility of the cursor. * * 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 (object_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_CALLBACK (gtk_text_view_toggle_cursor_visible), NULL, NULL, _gtk_marshal_VOID__VOID, 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. * * Since: 2.20 */ signals[PREEDIT_CHANGED] = g_signal_new_class_handler (I_("preedit-changed"), G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, NULL, NULL, NULL, _gtk_marshal_VOID__STRING, G_TYPE_NONE, 1, G_TYPE_STRING); /* * Key bindings */ binding_set = gtk_binding_set_by_class (klass); /* Moving the insertion point */ add_move_binding (binding_set, GDK_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (binding_set, GDK_KP_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (binding_set, GDK_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (binding_set, GDK_KP_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (binding_set, GDK_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (binding_set, GDK_KP_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (binding_set, GDK_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (binding_set, GDK_KP_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (binding_set, GDK_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); add_move_binding (binding_set, GDK_KP_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); add_move_binding (binding_set, GDK_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); add_move_binding (binding_set, GDK_KP_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); add_move_binding (binding_set, GDK_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, -1); add_move_binding (binding_set, GDK_KP_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, -1); add_move_binding (binding_set, GDK_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, 1); add_move_binding (binding_set, GDK_KP_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_PARAGRAPHS, 1); add_move_binding (binding_set, GDK_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (binding_set, GDK_KP_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (binding_set, GDK_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (binding_set, GDK_KP_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (binding_set, GDK_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (binding_set, GDK_KP_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (binding_set, GDK_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); add_move_binding (binding_set, GDK_KP_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); add_move_binding (binding_set, GDK_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); add_move_binding (binding_set, GDK_KP_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); add_move_binding (binding_set, GDK_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); add_move_binding (binding_set, GDK_KP_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); add_move_binding (binding_set, GDK_Page_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, -1); add_move_binding (binding_set, GDK_KP_Page_Up, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, -1); add_move_binding (binding_set, GDK_Page_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, 1); add_move_binding (binding_set, GDK_KP_Page_Down, GDK_CONTROL_MASK, GTK_MOVEMENT_HORIZONTAL_PAGES, 1); /* Select all */ gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "select-all", 1, G_TYPE_BOOLEAN, TRUE); gtk_binding_entry_add_signal (binding_set, GDK_slash, GDK_CONTROL_MASK, "select-all", 1, G_TYPE_BOOLEAN, TRUE); /* Unselect all */ gtk_binding_entry_add_signal (binding_set, GDK_backslash, GDK_CONTROL_MASK, "select-all", 1, G_TYPE_BOOLEAN, FALSE); gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "select-all", 1, G_TYPE_BOOLEAN, FALSE); /* Deleting text */ gtk_binding_entry_add_signal (binding_set, GDK_Delete, 0, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_CHARS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_KP_Delete, 0, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_CHARS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, 0, "backspace", 0); /* Make this do the same as Backspace, to help with mis-typing */ gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, GDK_SHIFT_MASK, "backspace", 0); gtk_binding_entry_add_signal (binding_set, GDK_Delete, GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_WORD_ENDS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_KP_Delete, GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_WORD_ENDS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_WORD_ENDS, G_TYPE_INT, -1); gtk_binding_entry_add_signal (binding_set, GDK_Delete, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_PARAGRAPH_ENDS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_KP_Delete, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_PARAGRAPH_ENDS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_PARAGRAPH_ENDS, G_TYPE_INT, -1); /* Cut/copy/paste */ gtk_binding_entry_add_signal (binding_set, GDK_x, GDK_CONTROL_MASK, "cut-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_c, GDK_CONTROL_MASK, "copy-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_v, GDK_CONTROL_MASK, "paste-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_Delete, GDK_SHIFT_MASK, "cut-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_Insert, GDK_CONTROL_MASK, "copy-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_Insert, GDK_SHIFT_MASK, "paste-clipboard", 0); /* Overwrite */ gtk_binding_entry_add_signal (binding_set, GDK_Insert, 0, "toggle-overwrite", 0); gtk_binding_entry_add_signal (binding_set, GDK_KP_Insert, 0, "toggle-overwrite", 0); /* Caret mode */ gtk_binding_entry_add_signal (binding_set, GDK_F7, 0, "toggle-cursor-visible", 0); /* Control-tab focus motion */ gtk_binding_entry_add_signal (binding_set, GDK_Tab, GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, GTK_DIR_TAB_FORWARD); gtk_binding_entry_add_signal (binding_set, GDK_KP_Tab, GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, GTK_DIR_TAB_FORWARD); gtk_binding_entry_add_signal (binding_set, GDK_Tab, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, GTK_DIR_TAB_BACKWARD); gtk_binding_entry_add_signal (binding_set, GDK_KP_Tab, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, GTK_DIR_TAB_BACKWARD); g_type_class_add_private (gobject_class, sizeof (GtkTextViewPrivate)); } static void gtk_text_view_init (GtkTextView *text_view) { GtkWidget *widget = GTK_WIDGET (text_view); GtkTargetList *target_list; GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); gtk_widget_set_can_focus (widget, TRUE); /* Set up default style */ text_view->wrap_mode = GTK_WRAP_NONE; text_view->pixels_above_lines = 0; text_view->pixels_below_lines = 0; text_view->pixels_inside_wrap = 0; text_view->justify = GTK_JUSTIFY_LEFT; text_view->left_margin = 0; text_view->right_margin = 0; text_view->indent = 0; text_view->tabs = NULL; text_view->editable = TRUE; priv->scroll_after_paste = TRUE; gtk_drag_dest_set (widget, 0, NULL, 0, GDK_ACTION_COPY | GDK_ACTION_MOVE); target_list = gtk_target_list_new (NULL, 0); gtk_drag_dest_set_target_list (widget, target_list); gtk_target_list_unref (target_list); text_view->virtual_cursor_x = -1; text_view->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 (). */ text_view->im_context = gtk_im_multicontext_new (); g_signal_connect (text_view->im_context, "commit", G_CALLBACK (gtk_text_view_commit_handler), text_view); g_signal_connect (text_view->im_context, "preedit-changed", G_CALLBACK (gtk_text_view_preedit_changed_handler), text_view); g_signal_connect (text_view->im_context, "retrieve-surrounding", G_CALLBACK (gtk_text_view_retrieve_surrounding_handler), text_view); g_signal_connect (text_view->im_context, "delete-surrounding", G_CALLBACK (gtk_text_view_delete_surrounding_handler), text_view); text_view->cursor_visible = TRUE; text_view->accepts_tab = TRUE; text_view->text_window = text_window_new (GTK_TEXT_WINDOW_TEXT, widget, 200, 200); text_view->drag_start_x = -1; text_view->drag_start_y = -1; text_view->pending_place_cursor_button = 0; /* We handle all our own redrawing */ gtk_widget_set_redraw_on_allocate (widget, FALSE); } /** * 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(). * * Return value: 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. * * Return value: 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) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (buffer == NULL || GTK_IS_TEXT_BUFFER (buffer)); if (text_view->buffer == buffer) return; if (text_view->buffer != NULL) { /* Destroy all anchored children */ GSList *tmp_list; GSList *copy; copy = g_slist_copy (text_view->children); tmp_list = copy; while (tmp_list != NULL) { GtkTextViewChild *vc = tmp_list->data; if (vc->anchor) { gtk_widget_destroy (vc->widget); /* vc may now be invalid! */ } tmp_list = g_slist_next (tmp_list); } g_slist_free (copy); g_signal_handlers_disconnect_by_func (text_view->buffer, gtk_text_view_mark_set_handler, text_view); g_signal_handlers_disconnect_by_func (text_view->buffer, gtk_text_view_target_list_notify, text_view); g_signal_handlers_disconnect_by_func (text_view->buffer, gtk_text_view_paste_done_handler, text_view); if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_PRIMARY); gtk_text_buffer_remove_selection_clipboard (text_view->buffer, clipboard); } if (text_view->layout) gtk_text_layout_set_buffer (text_view->layout, NULL); g_object_unref (text_view->buffer); text_view->dnd_mark = NULL; text_view->first_para_mark = NULL; cancel_pending_scroll (text_view); } text_view->buffer = buffer; if (text_view->layout) gtk_text_layout_set_buffer (text_view->layout, buffer); if (buffer != NULL) { GtkTextIter start; g_object_ref (buffer); gtk_text_buffer_get_iter_at_offset (text_view->buffer, &start, 0); text_view->dnd_mark = gtk_text_buffer_create_mark (text_view->buffer, "gtk_drag_target", &start, FALSE); text_view->first_para_mark = gtk_text_buffer_create_mark (text_view->buffer, NULL, &start, TRUE); text_view->first_para_pixels = 0; g_signal_connect (text_view->buffer, "mark-set", G_CALLBACK (gtk_text_view_mark_set_handler), text_view); g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view); g_signal_connect (text_view->buffer, "paste-done", G_CALLBACK (gtk_text_view_paste_done_handler), text_view); gtk_text_view_target_list_notify (text_view->buffer, NULL, text_view); if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_PRIMARY); gtk_text_buffer_add_selection_clipboard (text_view->buffer, clipboard); } } 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* get_buffer (GtkTextView *text_view) { if (text_view->buffer == NULL) { GtkTextBuffer *b; b = gtk_text_buffer_new (NULL); gtk_text_view_set_buffer (text_view, b); g_object_unref (b); } return text_view->buffer; } /** * 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. * * Return value: (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_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(). **/ void gtk_text_view_get_iter_at_location (GtkTextView *text_view, GtkTextIter *iter, gint x, gint y) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (iter != NULL); gtk_text_view_ensure_layout (text_view); gtk_text_layout_get_iter_at_pixel (text_view->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. * * Since: 2.6 **/ void gtk_text_view_get_iter_at_position (GtkTextView *text_view, GtkTextIter *iter, gint *trailing, gint x, gint y) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (iter != NULL); gtk_text_view_ensure_layout (text_view); gtk_text_layout_get_iter_at_position (text_view->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->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, gint *y, gint *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->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, gint y, gint *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->layout, target_iter, y, line_top); } static gboolean set_adjustment_clamped (GtkAdjustment *adj, gdouble val) { DV (g_print (" Setting adj to raw value %g\n", val)); /* We don't really want to clamp to upper; we want to clamp to upper - page_size which is the highest value the scrollbar will let us reach. */ if (val > (adj->upper - adj->page_size)) val = adj->upper - adj->page_size; if (val < adj->lower) val = adj->lower; if (val != adj->value) { DV (g_print (" Setting adj to clamped value %g\n", val)); gtk_adjustment_set_value (adj, val); return TRUE; } else return FALSE; } /** * 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. * * Return value: %TRUE if scrolling occurred **/ gboolean gtk_text_view_scroll_to_iter (GtkTextView *text_view, GtkTextIter *iter, gdouble within_margin, gboolean use_align, gdouble xalign, gdouble yalign) { GdkRectangle rect; GdkRectangle screen; gint screen_bottom; gint screen_right; gint scroll_dest; GtkWidget *widget; gboolean retval = FALSE; gint scroll_inc; gint screen_xoffset, screen_yoffset; gint current_x_scroll, current_y_scroll; /* 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 (text_view->layout, iter, &rect); DV (g_print (" target rect %d,%d %d x %d\n", rect.x, rect.y, rect.width, rect.height)); current_x_scroll = text_view->xoffset; current_y_scroll = text_view->yoffset; screen.x = current_x_scroll; screen.y = current_y_scroll; screen.width = SCREEN_WIDTH (widget); screen.height = SCREEN_HEIGHT (widget); screen_xoffset = screen.width * within_margin; screen_yoffset = screen.height * within_margin; screen.x += screen_xoffset; screen.y += screen_yoffset; screen.width -= screen_xoffset * 2; screen.height -= screen_yoffset * 2; /* paranoia check */ if (screen.width < 1) screen.width = 1; if (screen.height < 1) screen.height = 1; /* The -1 here ensures that we leave enough space to draw the cursor * when this function is used for horizontal scrolling. */ screen_right = screen.x + screen.width - 1; screen_bottom = screen.y + screen.height; /* 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. */ /* Vertical scroll */ scroll_inc = 0; scroll_dest = current_y_scroll; if (use_align) { scroll_dest = rect.y + (rect.height * yalign) - (screen.height * yalign); /* if scroll_dest < screen.y, we move a negative increment (up), * else a positive increment (down) */ scroll_inc = scroll_dest - screen.y + screen_yoffset; } else { /* move minimum to get onscreen */ if (rect.y < screen.y) { scroll_dest = rect.y; scroll_inc = scroll_dest - screen.y - screen_yoffset; } else if ((rect.y + rect.height) > screen_bottom) { scroll_dest = rect.y + rect.height; scroll_inc = scroll_dest - screen_bottom + screen_yoffset; } } if (scroll_inc != 0) { retval = set_adjustment_clamped (get_vadjustment (text_view), current_y_scroll + scroll_inc); DV (g_print (" vert increment %d\n", scroll_inc)); } /* Horizontal scroll */ scroll_inc = 0; scroll_dest = current_x_scroll; if (use_align) { scroll_dest = rect.x + (rect.width * xalign) - (screen.width * xalign); /* if scroll_dest < screen.y, we move a negative increment (left), * else a positive increment (right) */ scroll_inc = scroll_dest - screen.x + screen_xoffset; } else { /* move minimum to get onscreen */ if (rect.x < screen.x) { scroll_dest = rect.x; scroll_inc = scroll_dest - screen.x - screen_xoffset; } else if ((rect.x + rect.width) > screen_right) { scroll_dest = rect.x + rect.width; scroll_inc = scroll_dest - screen_right + screen_xoffset; } } if (scroll_inc != 0) { retval = set_adjustment_clamped (get_hadjustment (text_view), current_x_scroll + scroll_inc); DV (g_print (" horiz increment %d\n", scroll_inc)); } if (retval) { DV(g_print (">Actually scrolled ("G_STRLOC")\n")); } else { DV(g_print (">Didn't end up scrolling ("G_STRLOC")\n")); } return retval; } 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_free (scroll); } static void cancel_pending_scroll (GtkTextView *text_view) { if (text_view->pending_scroll) { free_pending_scroll (text_view->pending_scroll); text_view->pending_scroll = NULL; } } static void gtk_text_view_queue_scroll (GtkTextView *text_view, GtkTextMark *mark, gdouble within_margin, gboolean use_align, gdouble xalign, gdouble yalign) { GtkTextIter iter; GtkTextPendingScroll *scroll; DV(g_print(G_STRLOC"\n")); scroll = g_new (GtkTextPendingScroll, 1); 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->pending_scroll = scroll; } static gboolean gtk_text_view_flush_scroll (GtkTextView *text_view) { GtkTextIter iter; GtkTextPendingScroll *scroll; gboolean retval; GtkWidget *widget; widget = GTK_WIDGET (text_view); DV(g_print(G_STRLOC"\n")); if (text_view->pending_scroll == NULL) { DV (g_print ("in flush scroll, no pending scroll\n")); return FALSE; } scroll = text_view->pending_scroll; /* avoid recursion */ text_view->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")); gtk_text_layout_validate_yrange (text_view->layout, &iter, - (widget->allocation.height * 2), widget->allocation.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); free_pending_scroll (scroll); return retval; } static void gtk_text_view_set_adjustment_upper (GtkAdjustment *adj, gdouble upper) { if (upper != adj->upper) { gdouble min = MAX (0.0, upper - adj->page_size); gboolean value_changed = FALSE; adj->upper = upper; if (adj->value > min) { adj->value = min; value_changed = TRUE; } gtk_adjustment_changed (adj); DV(g_print(">Changed adj upper to %g ("G_STRLOC")\n", upper)); if (value_changed) { DV(g_print(">Changed adj value because upper decreased ("G_STRLOC")\n")); gtk_adjustment_value_changed (adj); } } } static void gtk_text_view_update_adjustments (GtkTextView *text_view) { gint width = 0, height = 0; DV(g_print(">Updating adjustments ("G_STRLOC")\n")); if (text_view->layout) gtk_text_layout_get_size (text_view->layout, &width, &height); /* Make room for the cursor after the last character in the widest line */ width += SPACE_FOR_CURSOR; if (text_view->width != width || text_view->height != height) { if (text_view->width != width) text_view->width_changed = TRUE; text_view->width = width; text_view->height = height; gtk_text_view_set_adjustment_upper (get_hadjustment (text_view), MAX (SCREEN_WIDTH (text_view), width)); gtk_text_view_set_adjustment_upper (get_vadjustment (text_view), MAX (SCREEN_HEIGHT (text_view), height)); /* hadj/vadj exist since we called get_hadjustment/get_vadjustment above */ /* Set up the step sizes; we'll say that a page is our allocation minus one step, and a step is 1/10 of our allocation. */ text_view->hadjustment->step_increment = SCREEN_WIDTH (text_view) / 10.0; text_view->hadjustment->page_increment = SCREEN_WIDTH (text_view) * 0.9; text_view->vadjustment->step_increment = SCREEN_HEIGHT (text_view) / 10.0; text_view->vadjustment->page_increment = SCREEN_HEIGHT (text_view) * 0.9; gtk_adjustment_changed (get_hadjustment (text_view)); gtk_adjustment_changed (get_vadjustment (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->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->layout == NULL) return; gtk_text_view_get_cursor_location (text_view, &area); area.x -= text_view->xoffset; area.y -= text_view->yoffset; /* Width returned by Pango indicates direction of cursor, * by it's sign more than the size of cursor. */ area.width = 0; gtk_im_context_set_cursor_location (text_view->im_context, &area); } static gboolean do_update_im_spot_location (gpointer text_view) { GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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 = GTK_TEXT_VIEW_GET_PRIVATE (text_view); /* 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 = gdk_threads_add_idle_full (GTK_TEXT_VIEW_PRIORITY_VALIDATE - 1, do_update_im_spot_location, text_view, NULL); } static void flush_update_im_spot_location (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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, gdouble within_margin, gboolean use_align, gdouble xalign, gdouble 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->layout && gtk_text_layout_is_valid (text_view->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->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. * * Return value: %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: 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->xoffset; visible_rect->y = text_view->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) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->wrap_mode != wrap_mode) { text_view->wrap_mode = wrap_mode; if (text_view->layout) { text_view->layout->default_style->wrap_mode = wrap_mode; gtk_text_layout_default_style_changed (text_view->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. * * Return value: 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->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) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); setting = setting != FALSE; if (text_view->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 (text_view->im_context); } text_view->editable = setting; if (setting && gtk_widget_has_focus (GTK_WIDGET (text_view))) gtk_im_context_focus_in (text_view->im_context); if (text_view->layout) { gtk_text_layout_set_overwrite_mode (text_view->layout, text_view->overwrite_mode && text_view->editable); text_view->layout->default_style->editable = text_view->editable; gtk_text_layout_default_style_changed (text_view->layout); } 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. * * Return value: 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->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, gint pixels_above_lines) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->pixels_above_lines != pixels_above_lines) { text_view->pixels_above_lines = pixels_above_lines; if (text_view->layout) { text_view->layout->default_style->pixels_above_lines = pixels_above_lines; gtk_text_layout_default_style_changed (text_view->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. * * Return value: default number of pixels above paragraphs **/ gint 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->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, gint pixels_below_lines) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->pixels_below_lines != pixels_below_lines) { text_view->pixels_below_lines = pixels_below_lines; if (text_view->layout) { text_view->layout->default_style->pixels_below_lines = pixels_below_lines; gtk_text_layout_default_style_changed (text_view->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(). * * Return value: default number of blank pixels below paragraphs **/ gint 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->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, gint pixels_inside_wrap) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->pixels_inside_wrap != pixels_inside_wrap) { text_view->pixels_inside_wrap = pixels_inside_wrap; if (text_view->layout) { text_view->layout->default_style->pixels_inside_wrap = pixels_inside_wrap; gtk_text_layout_default_style_changed (text_view->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(). * * Return value: default number of pixels of blank space between wrapped lines **/ gint 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->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) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->justify != justification) { text_view->justify = justification; if (text_view->layout) { text_view->layout->default_style->justification = justification; gtk_text_layout_default_style_changed (text_view->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. * * Return value: 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->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. **/ void gtk_text_view_set_left_margin (GtkTextView *text_view, gint left_margin) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->left_margin != left_margin) { text_view->left_margin = left_margin; if (text_view->layout) { text_view->layout->default_style->left_margin = left_margin; gtk_text_layout_default_style_changed (text_view->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. * * Return value: left margin in pixels **/ gint gtk_text_view_get_left_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->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. **/ void gtk_text_view_set_right_margin (GtkTextView *text_view, gint right_margin) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->right_margin != right_margin) { text_view->right_margin = right_margin; if (text_view->layout) { text_view->layout->default_style->right_margin = right_margin; gtk_text_layout_default_style_changed (text_view->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. * * Return value: right margin in pixels **/ gint gtk_text_view_get_right_margin (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->right_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, gint indent) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->indent != indent) { text_view->indent = indent; if (text_view->layout) { text_view->layout->default_style->indent = indent; gtk_text_layout_default_style_changed (text_view->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. * * Return value: number of pixels of indentation **/ gint gtk_text_view_get_indent (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); return text_view->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) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->tabs) pango_tab_array_free (text_view->tabs); text_view->tabs = tabs ? pango_tab_array_copy (tabs) : NULL; if (text_view->layout) { /* some unkosher futzing in internal struct details... */ if (text_view->layout->default_style->tabs) pango_tab_array_free (text_view->layout->default_style->tabs); text_view->layout->default_style->tabs = text_view->tabs ? pango_tab_array_copy (text_view->tabs) : NULL; gtk_text_layout_default_style_changed (text_view->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(). * * Return value: 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->tabs ? pango_tab_array_copy (text_view->tabs) : NULL; } static void gtk_text_view_toggle_cursor_visible (GtkTextView *text_view) { gtk_text_view_set_cursor_visible (text_view, !text_view->cursor_visible); } /** * gtk_text_view_set_cursor_visible: * @text_view: a #GtkTextView * @setting: whether to show the insertion cursor * * Toggles whether the insertion point is displayed. A buffer with no editable * text probably shouldn't have a visible cursor, so you may want to turn * the cursor off. **/ void gtk_text_view_set_cursor_visible (GtkTextView *text_view, gboolean setting) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); setting = (setting != FALSE); if (text_view->cursor_visible != setting) { text_view->cursor_visible = setting; if (gtk_widget_has_focus (GTK_WIDGET (text_view))) { if (text_view->layout) { gtk_text_layout_set_cursor_visible (text_view->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 is being displayed. * * Return value: 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->cursor_visible; } /** * gtk_text_view_place_cursor_onscreen: * @text_view: a #GtkTextView * * Moves the cursor to the currently visible region of the * buffer, it it isn't there already. * * Return value: %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) { if (text_view->first_validate_idle != 0) { DV (g_print ("Removing first validate idle: %s\n", G_STRLOC)); g_source_remove (text_view->first_validate_idle); text_view->first_validate_idle = 0; } if (text_view->incremental_validate_idle != 0) { g_source_remove (text_view->incremental_validate_idle); text_view->incremental_validate_idle = 0; } } static void gtk_text_view_destroy (GtkObject *object) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (object); priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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->scroll_timeout) { g_source_remove (text_view->scroll_timeout); text_view->scroll_timeout = 0; } if (priv->im_spot_idle) { g_source_remove (priv->im_spot_idle); priv->im_spot_idle = 0; } GTK_OBJECT_CLASS (gtk_text_view_parent_class)->destroy (object); } static void gtk_text_view_finalize (GObject *object) { GtkTextView *text_view; GtkTextViewPrivate *priv; text_view = GTK_TEXT_VIEW (object); priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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); cancel_pending_scroll (text_view); if (text_view->tabs) pango_tab_array_free (text_view->tabs); if (text_view->hadjustment) g_object_unref (text_view->hadjustment); if (text_view->vadjustment) g_object_unref (text_view->vadjustment); text_window_free (text_view->text_window); if (text_view->left_window) text_window_free (text_view->left_window); if (text_view->top_window) text_window_free (text_view->top_window); if (text_view->right_window) text_window_free (text_view->right_window); if (text_view->bottom_window) text_window_free (text_view->bottom_window); g_object_unref (text_view->im_context); g_free (priv->im_module); 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 = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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_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 (text_view->im_context)) gtk_im_multicontext_set_context_id (GTK_IM_MULTICONTEXT (text_view->im_context), priv->im_module); 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 = GTK_TEXT_VIEW_GET_PRIVATE (text_view); switch (prop_id) { case PROP_PIXELS_ABOVE_LINES: g_value_set_int (value, text_view->pixels_above_lines); break; case PROP_PIXELS_BELOW_LINES: g_value_set_int (value, text_view->pixels_below_lines); break; case PROP_PIXELS_INSIDE_WRAP: g_value_set_int (value, text_view->pixels_inside_wrap); break; case PROP_EDITABLE: g_value_set_boolean (value, text_view->editable); break; case PROP_WRAP_MODE: g_value_set_enum (value, text_view->wrap_mode); break; case PROP_JUSTIFICATION: g_value_set_enum (value, text_view->justify); break; case PROP_LEFT_MARGIN: g_value_set_int (value, text_view->left_margin); break; case PROP_RIGHT_MARGIN: g_value_set_int (value, text_view->right_margin); break; case PROP_INDENT: g_value_set_int (value, text_view->indent); break; case PROP_TABS: g_value_set_boxed (value, text_view->tabs); break; case PROP_CURSOR_VISIBLE: g_value_set_boolean (value, text_view->cursor_visible); break; case PROP_BUFFER: g_value_set_object (value, get_buffer (text_view)); break; case PROP_OVERWRITE: g_value_set_boolean (value, text_view->overwrite_mode); break; case PROP_ACCEPTS_TAB: g_value_set_boolean (value, text_view->accepts_tab); break; case PROP_IM_MODULE: g_value_set_string (value, priv->im_module); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_text_view_size_request (GtkWidget *widget, GtkRequisition *requisition) { GtkTextView *text_view; GSList *tmp_list; gint focus_edge_width; gint focus_width; gboolean interior_focus; text_view = GTK_TEXT_VIEW (widget); gtk_widget_style_get (widget, "interior-focus", &interior_focus, "focus-line-width", &focus_width, NULL); if (interior_focus) focus_edge_width = 0; else focus_edge_width = focus_width; if (text_view->layout) { text_view->text_window->requisition.width = text_view->layout->width; text_view->text_window->requisition.height = text_view->layout->height; } else { text_view->text_window->requisition.width = 0; text_view->text_window->requisition.height = 0; } requisition->width = text_view->text_window->requisition.width + focus_edge_width * 2; requisition->height = text_view->text_window->requisition.height + focus_edge_width * 2; if (text_view->left_window) requisition->width += text_view->left_window->requisition.width; if (text_view->right_window) requisition->width += text_view->right_window->requisition.width; if (text_view->top_window) requisition->height += text_view->top_window->requisition.height; if (text_view->bottom_window) requisition->height += text_view->bottom_window->requisition.height; requisition->width += GTK_CONTAINER (text_view)->border_width * 2; requisition->height += GTK_CONTAINER (text_view)->border_width * 2; tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *child = tmp_list->data; if (child->anchor) { GtkRequisition child_req; GtkRequisition old_req; gtk_widget_get_child_requisition (child->widget, &old_req); gtk_widget_size_request (child->widget, &child_req); gtk_widget_get_child_requisition (child->widget, &child_req); /* Invalidate layout lines if required */ if (text_view->layout && (old_req.width != child_req.width || old_req.height != child_req.height)) gtk_text_child_anchor_queue_resize (child->anchor, text_view->layout); } else { GtkRequisition child_req; gtk_widget_size_request (child->widget, &child_req); } tmp_list = g_slist_next (tmp_list); } } static void gtk_text_view_compute_child_allocation (GtkTextView *text_view, GtkTextViewChild *vc, GtkAllocation *allocation) { gint 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->layout, &iter, &buffer_y, NULL); buffer_y += vc->from_top_of_line; allocation->x = vc->from_left_of_buffer - text_view->xoffset; allocation->y = buffer_y - text_view->yoffset; gtk_widget_get_child_requisition (vc->widget, &req); allocation->width = req.width; allocation->height = req.height; } static void gtk_text_view_update_child_allocation (GtkTextView *text_view, GtkTextViewChild *vc) { GtkAllocation allocation; gtk_text_view_compute_child_allocation (text_view, vc, &allocation); gtk_widget_size_allocate (vc->widget, &allocation); #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->yoffset); #endif } static void gtk_text_view_child_allocated (GtkTextLayout *layout, GtkWidget *child, gint x, gint y, gpointer data) { GtkTextViewChild *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_data (G_OBJECT (child), "gtk-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) { GSList *tmp_list; DV(g_print(G_STRLOC"\n")); tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *child = tmp_list->data; g_assert (child != NULL); if (child->anchor) { /* We need to force-validate the regions containing * children. */ GtkTextIter child_loc; 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_ALLOC_NEEDED (child->widget)) { GtkTextIter end = child_loc; gtk_text_iter_forward_char (&end); gtk_text_layout_invalidate (text_view->layout, &child_loc, &end); } gtk_text_layout_validate_yrange (text_view->layout, &child_loc, 0, 1); } else { GtkAllocation allocation; GtkRequisition child_req; allocation.x = child->x; allocation.y = child->y; gtk_widget_get_child_requisition (child->widget, &child_req); allocation.width = child_req.width; allocation.height = child_req.height; gtk_widget_size_allocate (child->widget, &allocation); } tmp_list = g_slist_next (tmp_list); } } static void gtk_text_view_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkTextView *text_view; GtkTextIter first_para; gint y; gint width, height; GdkRectangle text_rect; GdkRectangle left_rect; GdkRectangle right_rect; GdkRectangle top_rect; GdkRectangle bottom_rect; gint focus_edge_width; gint focus_width; gboolean interior_focus; gboolean size_changed; text_view = GTK_TEXT_VIEW (widget); DV(g_print(G_STRLOC"\n")); size_changed = widget->allocation.width != allocation->width || widget->allocation.height != allocation->height; widget->allocation = *allocation; if (gtk_widget_get_realized (widget)) { gdk_window_move_resize (widget->window, allocation->x, allocation->y, allocation->width, allocation->height); } /* distribute width/height among child windows. Ensure all * windows get at least a 1x1 allocation. */ gtk_widget_style_get (widget, "interior-focus", &interior_focus, "focus-line-width", &focus_width, NULL); if (interior_focus) focus_edge_width = 0; else focus_edge_width = focus_width; width = allocation->width - focus_edge_width * 2 - GTK_CONTAINER (text_view)->border_width * 2; if (text_view->left_window) left_rect.width = text_view->left_window->requisition.width; else left_rect.width = 0; width -= left_rect.width; if (text_view->right_window) right_rect.width = text_view->right_window->requisition.width; else right_rect.width = 0; width -= right_rect.width; text_rect.width = MAX (1, width); top_rect.width = text_rect.width; bottom_rect.width = text_rect.width; height = allocation->height - focus_edge_width * 2 - GTK_CONTAINER (text_view)->border_width * 2; if (text_view->top_window) top_rect.height = text_view->top_window->requisition.height; else top_rect.height = 0; height -= top_rect.height; if (text_view->bottom_window) bottom_rect.height = text_view->bottom_window->requisition.height; else bottom_rect.height = 0; 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 = focus_edge_width + GTK_CONTAINER (text_view)->border_width; top_rect.y = focus_edge_width + GTK_CONTAINER (text_view)->border_width; 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 (text_view->text_window, &text_rect); if (text_view->left_window) text_window_size_allocate (text_view->left_window, &left_rect); if (text_view->right_window) text_window_size_allocate (text_view->right_window, &right_rect); if (text_view->top_window) text_window_size_allocate (text_view->top_window, &top_rect); if (text_view->bottom_window) text_window_size_allocate (text_view->bottom_window, &bottom_rect); gtk_text_view_update_layout_width (text_view); /* Note that this will do some layout validation */ gtk_text_view_allocate_children (text_view); /* Ensure h/v adj exist */ get_hadjustment (text_view); get_vadjustment (text_view); text_view->hadjustment->page_size = SCREEN_WIDTH (text_view); text_view->hadjustment->page_increment = SCREEN_WIDTH (text_view) * 0.9; text_view->hadjustment->step_increment = SCREEN_WIDTH (text_view) * 0.1; text_view->hadjustment->lower = 0; text_view->hadjustment->upper = MAX (SCREEN_WIDTH (text_view), text_view->width); if (text_view->hadjustment->value > text_view->hadjustment->upper - text_view->hadjustment->page_size) gtk_adjustment_set_value (text_view->hadjustment, MAX (0, text_view->hadjustment->upper - text_view->hadjustment->page_size)); gtk_adjustment_changed (text_view->hadjustment); text_view->vadjustment->page_size = SCREEN_HEIGHT (text_view); text_view->vadjustment->page_increment = SCREEN_HEIGHT (text_view) * 0.9; text_view->vadjustment->step_increment = SCREEN_HEIGHT (text_view) * 0.1; text_view->vadjustment->lower = 0; text_view->vadjustment->upper = MAX (SCREEN_HEIGHT (text_view), text_view->height); /* Now adjust the value of the adjustment to keep the cursor at the * same place in the buffer */ gtk_text_view_get_first_para_iter (text_view, &first_para); gtk_text_layout_get_line_yrange (text_view->layout, &first_para, &y, NULL); y += text_view->first_para_pixels; if (y > text_view->vadjustment->upper - text_view->vadjustment->page_size) y = MAX (0, text_view->vadjustment->upper - text_view->vadjustment->page_size); if (y != text_view->yoffset) gtk_adjustment_set_value (text_view->vadjustment, y); gtk_adjustment_changed (text_view->vadjustment); /* 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); /* widget->window doesn't get auto-redrawn as the layout is computed, so has to * be invalidated */ if (size_changed && gtk_widget_get_realized (widget)) gdk_window_invalidate_rect (widget->window, NULL, FALSE); } 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->first_para_mark); } static void gtk_text_view_validate_onscreen (GtkTextView *text_view) { GtkWidget *widget = GTK_WIDGET (text_view); 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 (text_view->layout, &first_para, 0, text_view->first_para_pixels + SCREEN_HEIGHT (widget)); } text_view->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 (text_view->onscreen_validated); } static void gtk_text_view_flush_first_validate (GtkTextView *text_view) { if (text_view->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 (text_view->first_validate_idle); text_view->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 (text_view->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) || !text_view->onscreen_validated) gtk_text_view_validate_onscreen (text_view); DV(g_print(">Leaving first validate idle ("G_STRLOC")\n")); g_assert (text_view->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->layout, 2000); gtk_text_view_update_adjustments (text_view); if (gtk_text_layout_is_valid (text_view->layout)) { text_view->incremental_validate_idle = 0; result = FALSE; } return result; } static void gtk_text_view_invalidate (GtkTextView *text_view) { DV (g_print (">Invalidate, onscreen_validated = %d now FALSE ("G_STRLOC")\n", text_view->onscreen_validated)); text_view->onscreen_validated = FALSE; /* We'll invalidate when the layout is created */ if (text_view->layout == NULL) return; if (!text_view->first_validate_idle) { text_view->first_validate_idle = gdk_threads_add_idle_full (GTK_PRIORITY_RESIZE - 2, first_validate_callback, text_view, NULL); DV (g_print (G_STRLOC": adding first validate idle %d\n", text_view->first_validate_idle)); } if (!text_view->incremental_validate_idle) { text_view->incremental_validate_idle = gdk_threads_add_idle_full (GTK_TEXT_VIEW_PRIORITY_VALIDATE, incremental_validate_callback, text_view, NULL); DV (g_print (G_STRLOC": adding incremental validate idle %d\n", text_view->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, gint start_y, gint old_height, gint new_height, gpointer data) { GtkTextView *text_view; GtkWidget *widget; GdkRectangle visible_rect; GdkRectangle redraw_rect; text_view = GTK_TEXT_VIEW (data); widget = GTK_WIDGET (data); DV(g_print(">Lines Validated ("G_STRLOC")\n")); if (gtk_widget_get_realized (widget)) { gtk_text_view_get_visible_rect (text_view, &visible_rect); redraw_rect.x = visible_rect.x; redraw_rect.width = visible_rect.width; redraw_rect.y = start_y; if (old_height == new_height) redraw_rect.height = old_height; else if (start_y + old_height > visible_rect.y) redraw_rect.height = MAX (0, visible_rect.y + visible_rect.height - start_y); else redraw_rect.height = 0; if (gdk_rectangle_intersect (&redraw_rect, &visible_rect, &redraw_rect)) { /* text_window_invalidate_rect() takes buffer coordinates */ text_window_invalidate_rect (text_view->text_window, &redraw_rect); DV(g_print(" invalidated rect: %d,%d %d x %d\n", redraw_rect.x, redraw_rect.y, redraw_rect.width, redraw_rect.height)); if (text_view->left_window) text_window_invalidate_rect (text_view->left_window, &redraw_rect); if (text_view->right_window) text_window_invalidate_rect (text_view->right_window, &redraw_rect); if (text_view->top_window) text_window_invalidate_rect (text_view->top_window, &redraw_rect); if (text_view->bottom_window) text_window_invalidate_rect (text_view->bottom_window, &redraw_rect); queue_update_im_spot_location (text_view); } } if (old_height != new_height) { gboolean yoffset_changed = FALSE; GSList *tmp_list; int new_first_para_top; int old_first_para_top; GtkTextIter first; /* 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 text_view->yoffset. */ gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &first, text_view->first_para_mark); gtk_text_layout_get_line_yrange (layout, &first, &new_first_para_top, NULL); old_first_para_top = text_view->yoffset - text_view->first_para_pixels; if (new_first_para_top != old_first_para_top) { text_view->yoffset += new_first_para_top - old_first_para_top; get_vadjustment (text_view)->value = text_view->yoffset; yoffset_changed = TRUE; } if (yoffset_changed) { DV(g_print ("Changing scroll position (%s)\n", G_STRLOC)); gtk_adjustment_value_changed (get_vadjustment (text_view)); } /* FIXME be smarter about which anchored widgets we update */ tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *child = tmp_list->data; if (child->anchor) gtk_text_view_update_child_allocation (text_view, child); tmp_list = g_slist_next (tmp_list); } } { GtkRequisition old_req; GtkRequisition new_req; old_req = widget->requisition; /* Use this instead of gtk_widget_size_request wrapper * to avoid the optimization which just returns widget->requisition * if a resize hasn't been queued. */ GTK_WIDGET_GET_CLASS (widget)->size_request (widget, &new_req); if (old_req.width != new_req.width || old_req.height != new_req.height) { gtk_widget_queue_resize_no_redraw (widget); } } } static void gtk_text_view_realize (GtkWidget *widget) { GtkTextView *text_view; GdkWindowAttr attributes; gint attributes_mask; GSList *tmp_list; text_view = GTK_TEXT_VIEW (widget); gtk_widget_set_realized (widget, TRUE); attributes.window_type = GDK_WINDOW_CHILD; attributes.x = widget->allocation.x; attributes.y = widget->allocation.y; attributes.width = widget->allocation.width; attributes.height = widget->allocation.height; attributes.wclass = GDK_INPUT_OUTPUT; attributes.visual = gtk_widget_get_visual (widget); attributes.colormap = gtk_widget_get_colormap (widget); attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK; attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP; widget->window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask); gdk_window_set_user_data (widget->window, widget); /* must come before text_window_realize calls */ widget->style = gtk_style_attach (widget->style, widget->window); gdk_window_set_background (widget->window, &widget->style->bg[gtk_widget_get_state (widget)]); text_window_realize (text_view->text_window, widget); if (text_view->left_window) text_window_realize (text_view->left_window, widget); if (text_view->top_window) text_window_realize (text_view->top_window, widget); if (text_view->right_window) text_window_realize (text_view->right_window, widget); if (text_view->bottom_window) text_window_realize (text_view->bottom_window, widget); gtk_text_view_ensure_layout (text_view); if (text_view->buffer) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_PRIMARY); gtk_text_buffer_add_selection_clipboard (text_view->buffer, clipboard); } tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *vc = tmp_list->data; text_view_child_set_parent_window (text_view, vc); tmp_list = tmp_list->next; } /* 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; text_view = GTK_TEXT_VIEW (widget); if (text_view->buffer) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_PRIMARY); gtk_text_buffer_remove_selection_clipboard (text_view->buffer, clipboard); } gtk_text_view_remove_validate_idles (text_view); if (text_view->popup_menu) { gtk_widget_destroy (text_view->popup_menu); text_view->popup_menu = NULL; } text_window_unrealize (text_view->text_window); if (text_view->left_window) text_window_unrealize (text_view->left_window); if (text_view->top_window) text_window_unrealize (text_view->top_window); if (text_view->right_window) text_window_unrealize (text_view->right_window); if (text_view->bottom_window) text_window_unrealize (text_view->bottom_window); gtk_text_view_destroy_layout (text_view); GTK_WIDGET_CLASS (gtk_text_view_parent_class)->unrealize (widget); } static void gtk_text_view_set_background (GtkTextView *text_view) { GtkWidget *widget = GTK_WIDGET (text_view); gdk_window_set_background (widget->window, &widget->style->bg[gtk_widget_get_state (widget)]); gdk_window_set_background (text_view->text_window->bin_window, &widget->style->base[gtk_widget_get_state (widget)]); if (text_view->left_window) gdk_window_set_background (text_view->left_window->bin_window, &widget->style->bg[gtk_widget_get_state (widget)]); if (text_view->right_window) gdk_window_set_background (text_view->right_window->bin_window, &widget->style->bg[gtk_widget_get_state (widget)]); if (text_view->top_window) gdk_window_set_background (text_view->top_window->bin_window, &widget->style->bg[gtk_widget_get_state (widget)]); if (text_view->bottom_window) gdk_window_set_background (text_view->bottom_window->bin_window, &widget->style->bg[gtk_widget_get_state (widget)]); } static void gtk_text_view_style_set (GtkWidget *widget, GtkStyle *previous_style) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); PangoContext *ltr_context, *rtl_context; if (gtk_widget_get_realized (widget)) { gtk_text_view_set_background (text_view); } if (text_view->layout && previous_style) { gtk_text_view_set_attributes_from_style (text_view, text_view->layout->default_style, widget->style); 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 (text_view->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) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); if (text_view->layout) { text_view->layout->default_style->direction = gtk_widget_get_direction (widget); gtk_text_layout_default_style_changed (text_view->layout); } } static void gtk_text_view_state_changed (GtkWidget *widget, GtkStateType previous_state) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GdkCursor *cursor; if (gtk_widget_get_realized (widget)) { gtk_text_view_set_background (text_view); if (gtk_widget_is_sensitive (widget)) cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget), GDK_XTERM); else cursor = NULL; gdk_window_set_cursor (text_view->text_window->bin_window, cursor); if (cursor) gdk_cursor_unref (cursor); text_view->mouse_cursor_obscured = FALSE; } if (!gtk_widget_is_sensitive (widget)) { /* Clear any selection */ gtk_text_view_unselect (text_view); } gtk_widget_queue_draw (widget); } static void set_invisible_cursor (GdkWindow *window) { GdkDisplay *display; GdkCursor *cursor; display = gdk_window_get_display (window); cursor = gdk_cursor_new_for_display (display, GDK_BLANK_CURSOR); gdk_window_set_cursor (window, cursor); gdk_cursor_unref (cursor); } static void gtk_text_view_obscure_mouse_cursor (GtkTextView *text_view) { if (text_view->mouse_cursor_obscured) return; set_invisible_cursor (text_view->text_window->bin_window); text_view->mouse_cursor_obscured = TRUE; } static void gtk_text_view_unobscure_mouse_cursor (GtkTextView *text_view) { if (text_view->mouse_cursor_obscured) { GdkCursor *cursor; cursor = gdk_cursor_new_for_display (gtk_widget_get_display (GTK_WIDGET (text_view)), GDK_XTERM); gdk_window_set_cursor (text_view->text_window->bin_window, cursor); gdk_cursor_unref (cursor); text_view->mouse_cursor_obscured = FALSE; } } static void gtk_text_view_grab_notify (GtkWidget *widget, gboolean was_grabbed) { if (!was_grabbed) { gtk_text_view_end_selection_drag (GTK_TEXT_VIEW (widget)); gtk_text_view_unobscure_mouse_cursor (GTK_TEXT_VIEW (widget)); } } /* * Events */ static gboolean get_event_coordinates (GdkEvent *event, gint *x, gint *y) { if (event) switch (event->type) { case GDK_MOTION_NOTIFY: *x = event->motion.x; *y = event->motion.y; return TRUE; break; case GDK_BUTTON_PRESS: case GDK_2BUTTON_PRESS: case GDK_3BUTTON_PRESS: case GDK_BUTTON_RELEASE: *x = event->button.x; *y = event->button.y; return TRUE; break; case GDK_KEY_PRESS: case GDK_KEY_RELEASE: case GDK_ENTER_NOTIFY: case GDK_LEAVE_NOTIFY: case GDK_PROPERTY_NOTIFY: case GDK_SELECTION_CLEAR: case GDK_SELECTION_REQUEST: case GDK_SELECTION_NOTIFY: case GDK_PROXIMITY_IN: case GDK_PROXIMITY_OUT: case GDK_DRAG_ENTER: case GDK_DRAG_LEAVE: case GDK_DRAG_MOTION: case GDK_DRAG_STATUS: case GDK_DROP_START: case GDK_DROP_FINISHED: default: return FALSE; break; } return FALSE; } static gint emit_event_on_tags (GtkWidget *widget, GdkEvent *event, GtkTextIter *iter) { GSList *tags; GSList *tmp; gboolean retval = FALSE; tags = gtk_text_iter_get_tags (iter); tmp = tags; while (tmp != NULL) { GtkTextTag *tag = tmp->data; if (gtk_text_tag_event (tag, G_OBJECT (widget), event, iter)) { retval = TRUE; break; } tmp = g_slist_next (tmp); } g_slist_free (tags); return retval; } static gint gtk_text_view_event (GtkWidget *widget, GdkEvent *event) { GtkTextView *text_view; gint x = 0, y = 0; text_view = GTK_TEXT_VIEW (widget); if (text_view->layout == NULL || get_buffer (text_view) == NULL) return FALSE; if (event->any.window != text_view->text_window->bin_window) return FALSE; if (get_event_coordinates (event, &x, &y)) { GtkTextIter iter; x += text_view->xoffset; y += text_view->yoffset; /* FIXME this is slow and we do it twice per event. * My favorite solution is to have GtkTextLayout cache * the last couple lookups. */ gtk_text_layout_get_iter_at_pixel (text_view->layout, &iter, x, y); return emit_event_on_tags (widget, event, &iter); } else if (event->type == GDK_KEY_PRESS || event->type == GDK_KEY_RELEASE) { GtkTextIter iter; gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, gtk_text_buffer_get_insert (get_buffer (text_view))); return emit_event_on_tags (widget, event, &iter); } else return FALSE; } static gint gtk_text_view_key_press_event (GtkWidget *widget, GdkEventKey *event) { gboolean retval = FALSE; gboolean obscure = FALSE; GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextMark *insert; GtkTextIter iter; gboolean can_insert; if (text_view->layout == NULL || get_buffer (text_view) == NULL) return FALSE; /* Make sure input method knows where it is */ flush_update_im_spot_location (text_view); 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, text_view->editable); if (gtk_im_context_filter_keypress (text_view->im_context, event)) { text_view->need_im_reset = TRUE; if (!can_insert) gtk_text_view_reset_im_context (text_view); obscure = can_insert; retval = TRUE; } /* Binding set */ else if (GTK_WIDGET_CLASS (gtk_text_view_parent_class)->key_press_event (widget, event)) { retval = TRUE; } /* use overall editability not can_insert, more predictable for users */ else if (text_view->editable && (event->keyval == GDK_Return || event->keyval == GDK_ISO_Enter || event->keyval == GDK_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"); obscure = TRUE; retval = TRUE; } /* Pass through Tab as literal tab, unless Control is held down */ else if ((event->keyval == GDK_Tab || event->keyval == GDK_KP_Tab || event->keyval == GDK_ISO_Left_Tab) && !(event->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 (text_view->accepts_tab && text_view->editable) { gtk_text_view_reset_im_context (text_view); gtk_text_view_commit_text (text_view, "\t"); obscure = TRUE; } else g_signal_emit_by_name (text_view, "move-focus", (event->state & GDK_SHIFT_MASK) ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD); retval = TRUE; } else retval = FALSE; if (obscure) gtk_text_view_obscure_mouse_cursor (text_view); gtk_text_view_reset_blink_time (text_view); gtk_text_view_pend_cursor_blink (text_view); return retval; } static gint gtk_text_view_key_release_event (GtkWidget *widget, GdkEventKey *event) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextMark *insert; GtkTextIter iter; if (text_view->layout == NULL || get_buffer (text_view) == NULL) return FALSE; 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_can_insert (&iter, text_view->editable) && gtk_im_context_filter_keypress (text_view->im_context, event)) { text_view->need_im_reset = TRUE; return TRUE; } else return GTK_WIDGET_CLASS (gtk_text_view_parent_class)->key_release_event (widget, event); } static gint gtk_text_view_button_press_event (GtkWidget *widget, GdkEventButton *event) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (widget); gtk_widget_grab_focus (widget); if (event->window != text_view->text_window->bin_window) { /* Remove selection if any. */ gtk_text_view_unselect (text_view); return FALSE; } gtk_text_view_reset_blink_time (text_view); #if 0 /* debug hack */ if (event->button == 3 && (event->state & GDK_CONTROL_MASK) != 0) _gtk_text_buffer_spew (GTK_TEXT_VIEW (widget)->buffer); else if (event->button == 3) gtk_text_layout_spew (GTK_TEXT_VIEW (widget)->layout); #endif if (event->type == GDK_BUTTON_PRESS) { gtk_text_view_reset_im_context (text_view); if (event->button == 1) { /* If we're in the selection, start a drag copy/move of the * selection; otherwise, start creating a new selection. */ GtkTextIter iter; GtkTextIter start, end; gtk_text_layout_get_iter_at_pixel (text_view->layout, &iter, event->x + text_view->xoffset, event->y + text_view->yoffset); if (gtk_text_buffer_get_selection_bounds (get_buffer (text_view), &start, &end) && gtk_text_iter_in_range (&iter, &start, &end) && !(event->state & GDK_SHIFT_MASK)) { text_view->drag_start_x = event->x; text_view->drag_start_y = event->y; text_view->pending_place_cursor_button = event->button; } else { gtk_text_view_start_selection_drag (text_view, &iter, event); } return TRUE; } else if (event->button == 2) { GtkTextIter iter; GtkTextViewPrivate *priv; /* We do not want to scroll back to the insert iter when we paste with the middle button */ priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); priv->scroll_after_paste = FALSE; gtk_text_layout_get_iter_at_pixel (text_view->layout, &iter, event->x + text_view->xoffset, event->y + text_view->yoffset); gtk_text_buffer_paste_clipboard (get_buffer (text_view), gtk_widget_get_clipboard (widget, GDK_SELECTION_PRIMARY), &iter, text_view->editable); return TRUE; } else if (event->button == 3) { gtk_text_view_do_popup (text_view, event); return TRUE; } } else if ((event->type == GDK_2BUTTON_PRESS || event->type == GDK_3BUTTON_PRESS) && event->button == 1) { GtkTextIter iter; gtk_text_view_end_selection_drag (text_view); gtk_text_layout_get_iter_at_pixel (text_view->layout, &iter, event->x + text_view->xoffset, event->y + text_view->yoffset); gtk_text_view_start_selection_drag (text_view, &iter, event); return TRUE; } return FALSE; } static gint gtk_text_view_button_release_event (GtkWidget *widget, GdkEventButton *event) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (widget); if (event->window != text_view->text_window->bin_window) return FALSE; if (event->button == 1) { if (text_view->drag_start_x >= 0) { text_view->drag_start_x = -1; text_view->drag_start_y = -1; } if (gtk_text_view_end_selection_drag (GTK_TEXT_VIEW (widget))) return TRUE; else if (text_view->pending_place_cursor_button == event->button) { 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 (text_view->layout, &iter, event->x + text_view->xoffset, event->y + text_view->yoffset); gtk_text_buffer_place_cursor (get_buffer (text_view), &iter); gtk_text_view_check_cursor_blink (text_view); text_view->pending_place_cursor_button = 0; return FALSE; } } return FALSE; } static void keymap_direction_changed (GdkKeymap *keymap, GtkTextView *text_view) { gtk_text_view_check_keymap_direction (text_view); } static gint gtk_text_view_focus_in_event (GtkWidget *widget, GdkEventFocus *event) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); gtk_widget_queue_draw (widget); DV(g_print (G_STRLOC": focus_in_event\n")); gtk_text_view_reset_blink_time (text_view); if (text_view->cursor_visible && text_view->layout) { gtk_text_layout_set_cursor_visible (text_view->layout, TRUE); gtk_text_view_check_cursor_blink (text_view); } g_signal_connect (gdk_keymap_get_for_display (gtk_widget_get_display (widget)), "direction-changed", G_CALLBACK (keymap_direction_changed), text_view); gtk_text_view_check_keymap_direction (text_view); if (text_view->editable) { text_view->need_im_reset = TRUE; gtk_im_context_focus_in (GTK_TEXT_VIEW (widget)->im_context); } return FALSE; } static gint gtk_text_view_focus_out_event (GtkWidget *widget, GdkEventFocus *event) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); gtk_text_view_end_selection_drag (text_view); gtk_widget_queue_draw (widget); DV(g_print (G_STRLOC": focus_out_event\n")); if (text_view->cursor_visible && text_view->layout) { gtk_text_view_check_cursor_blink (text_view); gtk_text_layout_set_cursor_visible (text_view->layout, FALSE); } g_signal_handlers_disconnect_by_func (gdk_keymap_get_for_display (gtk_widget_get_display (widget)), keymap_direction_changed, text_view); if (text_view->editable) { text_view->need_im_reset = TRUE; gtk_im_context_focus_out (GTK_TEXT_VIEW (widget)->im_context); } return FALSE; } static gint gtk_text_view_motion_event (GtkWidget *widget, GdkEventMotion *event) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); gtk_text_view_unobscure_mouse_cursor (text_view); if (event->window == text_view->text_window->bin_window && text_view->drag_start_x >= 0) { gint x = event->x; gint y = event->y; gdk_event_request_motions (event); if (gtk_drag_check_threshold (widget, text_view->drag_start_x, text_view->drag_start_y, x, y)) { GtkTextIter iter; gint buffer_x, buffer_y; gtk_text_view_window_to_buffer_coords (text_view, GTK_TEXT_WINDOW_TEXT, text_view->drag_start_x, text_view->drag_start_y, &buffer_x, &buffer_y); gtk_text_layout_get_iter_at_pixel (text_view->layout, &iter, buffer_x, buffer_y); gtk_text_view_start_selection_dnd (text_view, &iter, event); return TRUE; } } return FALSE; } static void gtk_text_view_paint (GtkWidget *widget, GdkRectangle *area, GdkEventExpose *event) { GtkTextView *text_view; GList *child_exposes; GList *tmp_list; text_view = GTK_TEXT_VIEW (widget); g_return_if_fail (text_view->layout != NULL); g_return_if_fail (text_view->xoffset >= 0); g_return_if_fail (text_view->yoffset >= 0); while (text_view->first_validate_idle != 0) { DV (g_print (G_STRLOC": first_validate_idle: %d\n", text_view->first_validate_idle)); gtk_text_view_flush_first_validate (text_view); } if (!text_view->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 (); } #if 0 printf ("painting %d,%d %d x %d\n", area->x, area->y, area->width, area->height); #endif child_exposes = NULL; gtk_text_layout_draw (text_view->layout, widget, text_view->text_window->bin_window, NULL, text_view->xoffset, text_view->yoffset, area->x, area->y, area->width, area->height, &child_exposes); tmp_list = child_exposes; while (tmp_list != NULL) { GtkWidget *child = tmp_list->data; gtk_container_propagate_expose (GTK_CONTAINER (text_view), child, event); g_object_unref (child); tmp_list = tmp_list->next; } g_list_free (child_exposes); } static gint gtk_text_view_expose_event (GtkWidget *widget, GdkEventExpose *event) { GSList *tmp_list; if (event->window == gtk_text_view_get_window (GTK_TEXT_VIEW (widget), GTK_TEXT_WINDOW_TEXT)) { DV(g_print (">Exposed ("G_STRLOC")\n")); gtk_text_view_paint (widget, &event->area, event); } if (event->window == widget->window) gtk_text_view_draw_focus (widget); /* Propagate exposes to all unanchored children. * Anchored children are handled in gtk_text_view_paint(). */ tmp_list = GTK_TEXT_VIEW (widget)->children; while (tmp_list != NULL) { GtkTextViewChild *vc = tmp_list->data; /* propagate_expose checks that event->window matches * child->window */ if (!vc->anchor) gtk_container_propagate_expose (GTK_CONTAINER (widget), vc->widget, event); tmp_list = tmp_list->next; } return FALSE; } static void gtk_text_view_draw_focus (GtkWidget *widget) { gboolean interior_focus; /* We clear the focus if we are in interior focus mode. */ gtk_widget_style_get (widget, "interior-focus", &interior_focus, NULL); if (gtk_widget_is_drawable (widget)) { if (gtk_widget_has_focus (widget) && !interior_focus) { gtk_paint_focus (widget->style, widget->window, gtk_widget_get_state (widget), NULL, widget, "textview", 0, 0, widget->allocation.width, widget->allocation.height); } else { gdk_window_clear (widget->window); } } } static gboolean gtk_text_view_focus (GtkWidget *widget, GtkDirectionType direction) { GtkContainer *container; gboolean result; container = GTK_CONTAINER (widget); if (!gtk_widget_is_focus (widget) && container->focus_child == NULL) { gtk_widget_grab_focus (widget); return TRUE; } else { /* * Unset CAN_FOCUS flag so that gtk_container_focus() allows * children to get the focus */ gtk_widget_set_can_focus (widget, FALSE); result = GTK_WIDGET_CLASS (gtk_text_view_parent_class)->focus (widget, direction); gtk_widget_set_can_focus (widget, TRUE); return result; } } static void gtk_text_view_move_focus (GtkWidget *widget, GtkDirectionType direction_type) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); if (GTK_TEXT_VIEW_GET_CLASS (text_view)->move_focus) GTK_TEXT_VIEW_GET_CLASS (text_view)->move_focus (text_view, direction_type); } /* * Container */ static void gtk_text_view_add (GtkContainer *container, GtkWidget *child) { /* This is pretty random. */ gtk_text_view_add_child_in_window (GTK_TEXT_VIEW (container), child, GTK_TEXT_WINDOW_WIDGET, 0, 0); } static void gtk_text_view_remove (GtkContainer *container, GtkWidget *child) { GSList *iter; GtkTextView *text_view; GtkTextViewChild *vc; text_view = GTK_TEXT_VIEW (container); vc = NULL; iter = text_view->children; while (iter != NULL) { vc = iter->data; if (vc->widget == child) break; iter = g_slist_next (iter); } g_assert (iter != NULL); /* be sure we had the child in the list */ text_view->children = g_slist_remove (text_view->children, vc); gtk_widget_unparent (vc->widget); text_view_child_free (vc); } static void gtk_text_view_forall (GtkContainer *container, gboolean include_internals, GtkCallback callback, gpointer callback_data) { GSList *iter; GtkTextView *text_view; GSList *copy; g_return_if_fail (GTK_IS_TEXT_VIEW (container)); g_return_if_fail (callback != NULL); text_view = GTK_TEXT_VIEW (container); copy = g_slist_copy (text_view->children); iter = copy; while (iter != NULL) { GtkTextViewChild *vc = iter->data; (* callback) (vc->widget, callback_data); iter = g_slist_next (iter); } g_slist_free (copy); } #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 if (gtk_debug_flags & GTK_DEBUG_UPDATES) return FALSE; g_object_get (settings, "gtk-cursor-blink", &blink, NULL); if (!blink) return FALSE; if (text_view->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->editable)) return blink; } return FALSE; } static gint get_cursor_time (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); gint time; g_object_get (settings, "gtk-cursor-blink-time", &time, NULL); return time; } static gint get_cursor_blink_timeout (GtkTextView *text_view) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); gint time; g_object_get (settings, "gtk-cursor-blink-timeout", &time, NULL); return time; } /* * Blink! */ static gint blink_cb (gpointer data) { GtkTextView *text_view; GtkTextViewPrivate *priv; gboolean visible; gint blink_timeout; text_view = GTK_TEXT_VIEW (data); priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); if (!gtk_widget_has_focus (GTK_WIDGET (text_view))) { g_warning ("GtkTextView - did not receive focus-out-event. If you\n" "connect a handler to this signal, it must return\n" "FALSE so the text view gets the event as well"); gtk_text_view_check_cursor_blink (text_view); return FALSE; } g_assert (text_view->layout); g_assert (text_view->cursor_visible); visible = gtk_text_layout_get_cursor_visible (text_view->layout); blink_timeout = get_cursor_blink_timeout (text_view); if (priv->blink_time > 1000 * blink_timeout && blink_timeout < G_MAXINT/1000) { /* we've blinked enough without the user doing anything, stop blinking */ visible = 0; text_view->blink_timeout = 0; } else if (visible) text_view->blink_timeout = gdk_threads_add_timeout (get_cursor_time (text_view) * CURSOR_OFF_MULTIPLIER / CURSOR_DIVIDER, blink_cb, text_view); else { text_view->blink_timeout = gdk_threads_add_timeout (get_cursor_time (text_view) * CURSOR_ON_MULTIPLIER / CURSOR_DIVIDER, blink_cb, text_view); priv->blink_time += get_cursor_time (text_view); } /* Block changed_handler while changing the layout's cursor visibility * because it would expose the whole paragraph. Instead, we expose * the cursor's area(s) manually below. */ g_signal_handlers_block_by_func (text_view->layout, changed_handler, text_view); gtk_text_layout_set_cursor_visible (text_view->layout, !visible); g_signal_handlers_unblock_by_func (text_view->layout, changed_handler, text_view); text_window_invalidate_cursors (text_view->text_window); /* Remove ourselves */ return FALSE; } static void gtk_text_view_stop_cursor_blink (GtkTextView *text_view) { if (text_view->blink_timeout) { g_source_remove (text_view->blink_timeout); text_view->blink_timeout = 0; } } static void gtk_text_view_check_cursor_blink (GtkTextView *text_view) { if (text_view->layout != NULL && text_view->cursor_visible && gtk_widget_has_focus (GTK_WIDGET (text_view))) { if (cursor_blinks (text_view)) { if (text_view->blink_timeout == 0) { gtk_text_layout_set_cursor_visible (text_view->layout, TRUE); text_view->blink_timeout = gdk_threads_add_timeout (get_cursor_time (text_view) * CURSOR_OFF_MULTIPLIER / CURSOR_DIVIDER, blink_cb, text_view); } } else { gtk_text_view_stop_cursor_blink (text_view); gtk_text_layout_set_cursor_visible (text_view->layout, TRUE); } } else { gtk_text_view_stop_cursor_blink (text_view); gtk_text_layout_set_cursor_visible (text_view->layout, FALSE); } } static void gtk_text_view_pend_cursor_blink (GtkTextView *text_view) { if (text_view->layout != NULL && text_view->cursor_visible && gtk_widget_has_focus (GTK_WIDGET (text_view)) && cursor_blinks (text_view)) { gtk_text_view_stop_cursor_blink (text_view); gtk_text_layout_set_cursor_visible (text_view->layout, TRUE); text_view->blink_timeout = gdk_threads_add_timeout (get_cursor_time (text_view) * CURSOR_PEND_MULTIPLIER / CURSOR_DIVIDER, blink_cb, text_view); } } static void gtk_text_view_reset_blink_time (GtkTextView *text_view) { GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); priv->blink_time = 0; } /* * Key binding handlers */ static gboolean gtk_text_view_move_iter_by_lines (GtkTextView *text_view, GtkTextIter *newplace, gint count) { gboolean ret = TRUE; while (count < 0) { ret = gtk_text_layout_move_iter_to_previous_line (text_view->layout, newplace); count++; } while (count > 0) { ret = gtk_text_layout_move_iter_to_next_line (text_view->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 void gtk_text_view_move_cursor_internal (GtkTextView *text_view, GtkMovementStep step, gint count, gboolean extend_selection) { GtkTextIter insert; GtkTextIter newplace; gboolean cancel_selection = FALSE; gint cursor_x_pos = 0; GtkDirectionType leave_direction = -1; if (!text_view->cursor_visible) { GtkScrollStep scroll_step; switch (step) { case GTK_MOVEMENT_VISUAL_POSITIONS: leave_direction = count > 0 ? GTK_DIR_RIGHT : GTK_DIR_LEFT; /* fall through */ 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; /* fall through */ 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; } if (!gtk_text_view_move_viewport (text_view, scroll_step, count)) { if (leave_direction != -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) { 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 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 (count > 0) 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 (text_view->layout, &newplace, count); break; case GTK_MOVEMENT_WORDS: 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 (text_view->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 (text_view->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 (text_view->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; default: break; } /* call move_cursor() even if the cursor hasn't moved, since it cancels the selection */ move_cursor (text_view, &newplace, extend_selection); if (!gtk_text_iter_equal (&insert, &newplace)) { 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); } else if (leave_direction != -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_cursor (GtkTextView *text_view, GtkMovementStep step, gint count, gboolean extend_selection) { gtk_text_view_move_cursor_internal (text_view, step, count, extend_selection); } static void gtk_text_view_page_horizontally (GtkTextView *text_view, gint count, gboolean extend_selection) { gtk_text_view_move_cursor_internal (text_view, GTK_MOVEMENT_HORIZONTAL_PAGES, count, extend_selection); } static gboolean gtk_text_view_move_viewport (GtkTextView *text_view, GtkScrollStep step, gint count) { GtkAdjustment *adjustment; gdouble increment; switch (step) { case GTK_SCROLL_STEPS: case GTK_SCROLL_PAGES: case GTK_SCROLL_ENDS: adjustment = get_vadjustment (text_view); break; case GTK_SCROLL_HORIZONTAL_STEPS: case GTK_SCROLL_HORIZONTAL_PAGES: case GTK_SCROLL_HORIZONTAL_ENDS: adjustment = get_hadjustment (text_view); break; default: adjustment = get_vadjustment (text_view); break; } switch (step) { case GTK_SCROLL_STEPS: case GTK_SCROLL_HORIZONTAL_STEPS: increment = adjustment->step_increment; break; case GTK_SCROLL_PAGES: case GTK_SCROLL_HORIZONTAL_PAGES: increment = adjustment->page_increment; break; case GTK_SCROLL_ENDS: case GTK_SCROLL_HORIZONTAL_ENDS: increment = adjustment->upper - adjustment->lower; break; default: increment = 0.0; break; } return set_adjustment_clamped (adjustment, adjustment->value + 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, gint count, gboolean extend_selection) { gdouble newval; gdouble oldval; GtkAdjustment *adj; gint cursor_x_pos, cursor_y_pos; GtkTextMark *insert_mark; GtkTextIter old_insert; GtkTextIter new_insert; GtkTextIter anchor; gint y0, y1; g_return_val_if_fail (text_view->vadjustment != NULL, FALSE); adj = text_view->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 (text_view->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 = adj->page_size; y1 = adj->page_size + count * adj->page_increment; } else { gtk_text_view_get_first_para_iter (text_view, &anchor); y0 = count * adj->page_increment + adj->page_size; y1 = 0; } gtk_text_layout_validate_yrange (text_view->layout, &anchor, y0, y1); /* FIXME do we need to update the adjustment ranges here? */ new_insert = old_insert; if (count < 0 && adj->value <= (adj->lower + 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 && adj->value >= (adj->upper - adj->page_size - 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 = adj->value; newval = adj->value; newval += count * adj->page_increment; set_adjustment_clamped (adj, newval); cursor_y_pos += adj->value - oldval; gtk_text_layout_get_iter_at_pixel (text_view->layout, &new_insert, cursor_x_pos, cursor_y_pos); clamp_iter_onscreen (text_view, &new_insert); 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")); gtk_text_view_scroll_mark_onscreen (text_view, insert_mark); return !gtk_text_iter_equal (&old_insert, &new_insert); } static gboolean gtk_text_view_scroll_hpages (GtkTextView *text_view, gint count, gboolean extend_selection) { gdouble newval; gdouble oldval; GtkAdjustment *adj; gint cursor_x_pos, cursor_y_pos; GtkTextMark *insert_mark; GtkTextIter old_insert; GtkTextIter new_insert; gint y, height; g_return_val_if_fail (text_view->hadjustment != NULL, FALSE); adj = text_view->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 (text_view->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 (text_view->layout, &old_insert, &y, &height); gtk_text_layout_validate_yrange (text_view->layout, &old_insert, y, y + height); /* FIXME do we need to update the adjustment ranges here? */ new_insert = old_insert; if (count < 0 && adj->value <= (adj->lower + 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 && adj->value >= (adj->upper - adj->page_size - 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 = adj->value; newval = adj->value; newval += count * adj->page_increment; set_adjustment_clamped (adj, newval); cursor_x_pos += adj->value - oldval; gtk_text_layout_get_iter_at_pixel (text_view->layout, &new_insert, cursor_x_pos, cursor_y_pos); clamp_iter_onscreen (text_view, &new_insert); 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")); gtk_text_view_scroll_mark_onscreen (text_view, insert_mark); 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 gchar *str) { if (!gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), str, -1, text_view->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } static void gtk_text_view_delete_from_cursor (GtkTextView *text_view, GtkDeleteType type, gint count) { GtkTextIter insert; GtkTextIter start; GtkTextIter end; gboolean leave_one = FALSE; 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, text_view->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, text_view->editable)) { if (leave_one) gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), " ", 1, text_view->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) { GtkTextIter insert; 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, text_view->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, text_view->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) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_CLIPBOARD); gtk_text_buffer_cut_clipboard (get_buffer (text_view), clipboard, text_view->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))); } static void gtk_text_view_copy_clipboard (GtkTextView *text_view) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_CLIPBOARD); 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) { GtkClipboard *clipboard = gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_CLIPBOARD); gtk_text_buffer_paste_clipboard (get_buffer (text_view), clipboard, NULL, text_view->editable); } static void gtk_text_view_paste_done_handler (GtkTextBuffer *buffer, GtkClipboard *clipboard, gpointer data) { GtkTextView *text_view = data; GtkTextViewPrivate *priv; priv = GTK_TEXT_VIEW_GET_PRIVATE (text_view); 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 = TRUE; } static void gtk_text_view_toggle_overwrite (GtkTextView *text_view) { if (text_view->text_window) text_window_invalidate_cursors (text_view->text_window); text_view->overwrite_mode = !text_view->overwrite_mode; if (text_view->layout) gtk_text_layout_set_overwrite_mode (text_view->layout, text_view->overwrite_mode && text_view->editable); if (text_view->text_window) text_window_invalidate_cursors (text_view->text_window); 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. * * Return value: whether @text_view is in overwrite mode or not. * * Since: 2.4 **/ gboolean gtk_text_view_get_overwrite (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return text_view->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. * * Since: 2.4 **/ 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->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. * * Since: 2.4 **/ 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->accepts_tab != accepts_tab) { text_view->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(). * * Return value: %TRUE if pressing the Tab key inserts a tab character, * %FALSE if pressing the Tab key moves the keyboard focus. * * Since: 2.4 **/ 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->accepts_tab; } static void gtk_text_view_compat_move_focus (GtkTextView *text_view, GtkDirectionType direction_type) { GSignalInvocationHint *hint = g_signal_get_invocation_hint (text_view); /* as of GTK+ 2.12, the "move-focus" signal has been moved to GtkWidget, * the evil code below makes sure that both emitting the signal and * calling the virtual function directly continue to work as expetcted */ if (hint->signal_id == g_signal_lookup ("move-focus", GTK_TYPE_WIDGET)) { /* if this is a signal emission, chain up */ gboolean retval; g_signal_chain_from_overridden_handler (text_view, direction_type, &retval); } else { /* otherwise emit the signal, since somebody called the virtual * function directly */ g_signal_emit_by_name (text_view, "move-focus", direction_type); } } /* * 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 get_iter_at_pointer (GtkTextView *text_view, GtkTextIter *iter, gint *x, gint *y) { gint xcoord, ycoord; GdkModifierType state; gdk_window_get_pointer (text_view->text_window->bin_window, &xcoord, &ycoord, &state); gtk_text_layout_get_iter_at_pixel (text_view->layout, iter, xcoord + text_view->xoffset, ycoord + text_view->yoffset); if (x) *x = xcoord; if (y) *y = ycoord; } static void move_mark_to_pointer_and_scroll (GtkTextView *text_view, const gchar *mark_name) { GtkTextIter newplace; GtkTextMark *mark; get_iter_at_pointer (text_view, &newplace, NULL, NULL); mark = gtk_text_buffer_get_mark (get_buffer (text_view), mark_name); /* This may invalidate the layout */ DV(g_print (G_STRLOC": move mark\n")); gtk_text_buffer_move_mark (get_buffer (text_view), 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->first_validate_idle)); } static gboolean selection_scan_timeout (gpointer data) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (data); DV(g_print (G_STRLOC": calling move_mark_to_pointer_and_scroll\n")); gtk_text_view_scroll_mark_onscreen (text_view, gtk_text_buffer_get_insert (get_buffer (text_view))); return TRUE; /* remain installed. */ } #define UPPER_OFFSET_ANCHOR 0.8 #define LOWER_OFFSET_ANCHOR 0.2 static gboolean check_scroll (gdouble offset, GtkAdjustment *adj) { if ((offset > UPPER_OFFSET_ANCHOR && adj->value + adj->page_size < adj->upper) || (offset < LOWER_OFFSET_ANCHOR && adj->value > adj->lower)) return TRUE; return FALSE; } static gint drag_scan_timeout (gpointer data) { GtkTextView *text_view; GtkTextIter newplace; gint x, y, width, height; gdouble pointer_xoffset, pointer_yoffset; text_view = GTK_TEXT_VIEW (data); get_iter_at_pointer (text_view, &newplace, &x, &y); width = gdk_window_get_width (text_view->text_window->bin_window); height = gdk_window_get_height (text_view->text_window->bin_window); gtk_text_buffer_move_mark (get_buffer (text_view), text_view->dnd_mark, &newplace); pointer_xoffset = (gdouble) x / width; pointer_yoffset = (gdouble) y / height; if (check_scroll (pointer_xoffset, text_view->hadjustment) || check_scroll (pointer_yoffset, text_view->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, text_view->dnd_mark, 0., TRUE, pointer_xoffset, pointer_yoffset); } return TRUE; } typedef enum { SELECT_CHARACTERS, SELECT_WORDS, SELECT_LINES } SelectionGranularity; /* * Move @start and @end to the boundaries of the selection unit (indicated by * @granularity) which contained @start initially. * If the selction unit is SELECT_WORDS and @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. */ static void extend_selection (GtkTextView *text_view, SelectionGranularity granularity, GtkTextIter *start, GtkTextIter *end) { *end = *start; if (granularity == SELECT_WORDS) { 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; 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); } } else if (granularity == SELECT_LINES) { 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); } } } typedef struct { SelectionGranularity granularity; GtkTextMark *orig_start; GtkTextMark *orig_end; } SelectionData; static void selection_data_free (SelectionData *data) { if (data->orig_start != NULL) gtk_text_buffer_delete_mark (gtk_text_mark_get_buffer (data->orig_start), data->orig_start); if (data->orig_end != NULL) gtk_text_buffer_delete_mark (gtk_text_mark_get_buffer (data->orig_end), data->orig_end); g_free (data); } static gint selection_motion_event_handler (GtkTextView *text_view, GdkEventMotion *event, SelectionData *data) { gdk_event_request_motions (event); if (data->granularity == SELECT_CHARACTERS) { move_mark_to_pointer_and_scroll (text_view, "insert"); } else { GtkTextIter cursor, 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_at_pointer (text_view, &cursor, NULL, NULL); start = cursor; extend_selection (text_view, data->granularity, &start, &end); /* either the selection extends to the front, or end (or not) */ if (gtk_text_iter_compare (&cursor, &orig_start) < 0) gtk_text_buffer_select_range (buffer, &start, &orig_end); else gtk_text_buffer_select_range (buffer, &end, &orig_start); 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->scroll_timeout != 0) /* reset on every motion event */ g_source_remove (text_view->scroll_timeout); text_view->scroll_timeout = gdk_threads_add_timeout (50, selection_scan_timeout, text_view); return TRUE; } static void gtk_text_view_start_selection_drag (GtkTextView *text_view, const GtkTextIter *iter, GdkEventButton *button) { GtkTextIter cursor, ins, bound; GtkTextIter orig_start, orig_end; GtkTextBuffer *buffer; SelectionData *data; if (text_view->selection_drag_handler != 0) return; data = g_new0 (SelectionData, 1); if (button->type == GDK_2BUTTON_PRESS) data->granularity = SELECT_WORDS; else if (button->type == GDK_3BUTTON_PRESS) data->granularity = SELECT_LINES; else data->granularity = SELECT_CHARACTERS; gtk_grab_add (GTK_WIDGET (text_view)); buffer = get_buffer (text_view); cursor = *iter; ins = cursor; extend_selection (text_view, data->granularity, &ins, &bound); orig_start = ins; orig_end = bound; if (button->state & GDK_SHIFT_MASK) { /* 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 tripple 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; orig_start = old_end; orig_end = old_end; } else { ins = bound; bound = old_start; orig_end = bound; orig_start = 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); gtk_text_view_check_cursor_blink (text_view); text_view->selection_drag_handler = g_signal_connect_data (text_view, "motion-notify-event", G_CALLBACK (selection_motion_event_handler), data, (GClosureNotify) selection_data_free, 0); } /* returns whether we were really dragging */ static gboolean gtk_text_view_end_selection_drag (GtkTextView *text_view) { if (text_view->selection_drag_handler == 0) return FALSE; g_signal_handler_disconnect (text_view, text_view->selection_drag_handler); text_view->selection_drag_handler = 0; if (text_view->scroll_timeout != 0) { g_source_remove (text_view->scroll_timeout); text_view->scroll_timeout = 0; } gtk_grab_remove (GTK_WIDGET (text_view)); return TRUE; } /* * Layout utils */ static void gtk_text_view_set_attributes_from_style (GtkTextView *text_view, GtkTextAttributes *values, GtkStyle *style) { values->appearance.bg_color = style->base[GTK_STATE_NORMAL]; values->appearance.fg_color = style->text[GTK_STATE_NORMAL]; if (values->font) pango_font_description_free (values->font); values->font = pango_font_description_copy (style->font_desc); } static void gtk_text_view_check_keymap_direction (GtkTextView *text_view) { if (text_view->layout) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (text_view)); GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (text_view))); GtkTextDirection new_cursor_dir; GtkTextDirection new_keyboard_dir; gboolean split_cursor; g_object_get (settings, "gtk-split-cursor", &split_cursor, NULL); if (gdk_keymap_get_direction (keymap) == 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 (text_view->layout, new_cursor_dir); gtk_text_layout_set_keyboard_direction (text_view->layout, new_keyboard_dir); } } static void gtk_text_view_ensure_layout (GtkTextView *text_view) { GtkWidget *widget; widget = GTK_WIDGET (text_view); if (text_view->layout == NULL) { GtkTextAttributes *style; PangoContext *ltr_context, *rtl_context; GSList *tmp_list; DV(g_print(G_STRLOC"\n")); text_view->layout = gtk_text_layout_new (); g_signal_connect (text_view->layout, "invalidated", G_CALLBACK (invalidated_handler), text_view); g_signal_connect (text_view->layout, "changed", G_CALLBACK (changed_handler), text_view); g_signal_connect (text_view->layout, "allocate-child", G_CALLBACK (gtk_text_view_child_allocated), text_view); if (get_buffer (text_view)) gtk_text_layout_set_buffer (text_view->layout, get_buffer (text_view)); if ((gtk_widget_has_focus (widget) && text_view->cursor_visible)) gtk_text_view_pend_cursor_blink (text_view); else gtk_text_layout_set_cursor_visible (text_view->layout, FALSE); gtk_text_layout_set_overwrite_mode (text_view->layout, text_view->overwrite_mode && text_view->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 (text_view->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_widget_ensure_style (widget); gtk_text_view_set_attributes_from_style (text_view, style, widget->style); style->pixels_above_lines = text_view->pixels_above_lines; style->pixels_below_lines = text_view->pixels_below_lines; style->pixels_inside_wrap = text_view->pixels_inside_wrap; style->left_margin = text_view->left_margin; style->right_margin = text_view->right_margin; style->indent = text_view->indent; style->tabs = text_view->tabs ? pango_tab_array_copy (text_view->tabs) : NULL; style->wrap_mode = text_view->wrap_mode; style->justification = text_view->justify; style->direction = gtk_widget_get_direction (GTK_WIDGET (text_view)); gtk_text_layout_set_default_style (text_view->layout, style); gtk_text_attributes_unref (style); /* Set layout for all anchored children */ tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *vc = tmp_list->data; if (vc->anchor) { gtk_text_anchored_child_set_layout (vc->widget, text_view->layout); /* vc may now be invalid! */ } tmp_list = g_slist_next (tmp_list); } gtk_text_view_invalidate (text_view); } } /** * gtk_text_view_get_default_attributes: * @text_view: a #GtkTextView * * Obtains a copy of the default text attributes. These are the * attributes used for text unless a tag overrides them. * You'd typically pass the default attributes in to * gtk_text_iter_get_attributes() in order to get the * attributes in effect at a given text position. * * The return value is a copy owned by the caller of this function, * and should be freed. * * Return value: a new #GtkTextAttributes **/ 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->layout->default_style); } static void gtk_text_view_destroy_layout (GtkTextView *text_view) { if (text_view->layout) { GSList *tmp_list; gtk_text_view_remove_validate_idles (text_view); g_signal_handlers_disconnect_by_func (text_view->layout, invalidated_handler, text_view); g_signal_handlers_disconnect_by_func (text_view->layout, changed_handler, text_view); /* Remove layout from all anchored children */ tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *vc = tmp_list->data; if (vc->anchor) { gtk_text_anchored_child_set_layout (vc->widget, NULL); /* vc may now be invalid! */ } tmp_list = g_slist_next (tmp_list); } gtk_text_view_stop_cursor_blink (text_view); gtk_text_view_end_selection_drag (text_view); g_object_unref (text_view->layout); text_view->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. * * Since: 2.22 */ void gtk_text_view_reset_im_context (GtkTextView *text_view) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); if (text_view->need_im_reset) { text_view->need_im_reset = FALSE; gtk_im_context_reset (text_view->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, * GdkEventKey *event) * { * if ((key->keyval == GDK_Return || key->keyval == GDK_KP_Enter)) * { * if (gtk_text_view_im_context_filter_keypress (GTK_TEXT_VIEW (view), event)) * return TRUE; * } * * /* Do some stuff */ * * return GTK_WIDGET_CLASS (gtk_foo_bar_parent_class)->key_press_event (widget, event); * } * ]| * * Return value: %TRUE if the input method handled the key event. * * Since: 2.22 */ gboolean gtk_text_view_im_context_filter_keypress (GtkTextView *text_view, GdkEventKey *event) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), FALSE); return gtk_im_context_filter_keypress (text_view->im_context, event); } /* * DND feature */ static void drag_begin_cb (GtkWidget *widget, GdkDragContext *context, gpointer data) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextBuffer *buffer = gtk_text_view_get_buffer (text_view); GtkTextIter start; GtkTextIter end; GdkPixmap *pixmap = NULL; g_signal_handlers_disconnect_by_func (widget, drag_begin_cb, NULL); if (gtk_text_buffer_get_selection_bounds (buffer, &start, &end)) pixmap = _gtk_text_util_create_rich_drag_icon (widget, buffer, &start, &end); if (pixmap) { gtk_drag_set_icon_pixmap (context, gdk_drawable_get_colormap (pixmap), pixmap, NULL, -2, -2); g_object_unref (pixmap); } else { gtk_drag_set_icon_default (context); } } static void gtk_text_view_start_selection_dnd (GtkTextView *text_view, const GtkTextIter *iter, GdkEventMotion *event) { GtkTargetList *target_list; text_view->drag_start_x = -1; text_view->drag_start_y = -1; text_view->pending_place_cursor_button = 0; target_list = gtk_text_buffer_get_copy_target_list (get_buffer (text_view)); g_signal_connect (text_view, "drag-begin", G_CALLBACK (drag_begin_cb), NULL); gtk_drag_begin (GTK_WIDGET (text_view), target_list, GDK_ACTION_COPY | GDK_ACTION_MOVE, 1, (GdkEvent*)event); } static void gtk_text_view_drag_begin (GtkWidget *widget, GdkDragContext *context) { /* do nothing */ } static void gtk_text_view_drag_end (GtkWidget *widget, GdkDragContext *context) { } static void gtk_text_view_drag_data_get (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time) { GtkTextView *text_view = GTK_TEXT_VIEW (widget); GtkTextBuffer *buffer = gtk_text_view_get_buffer (text_view); if (info == GTK_TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS) { gtk_selection_data_set (selection_data, gdk_atom_intern_static_string ("GTK_TEXT_BUFFER_CONTENTS"), 8, /* bytes */ (void*)&buffer, sizeof (buffer)); } else if (info == GTK_TEXT_BUFFER_TARGET_INFO_RICH_TEXT) { GtkTextIter start; GtkTextIter end; guint8 *str = NULL; gsize len; if (gtk_text_buffer_get_selection_bounds (buffer, &start, &end)) { /* Extract the selected text */ str = gtk_text_buffer_serialize (buffer, buffer, selection_data->target, &start, &end, &len); } if (str) { gtk_selection_data_set (selection_data, selection_data->target, 8, /* bytes */ (guchar *) str, len); g_free (str); } } else { GtkTextIter start; GtkTextIter end; gchar *str = NULL; if (gtk_text_buffer_get_selection_bounds (buffer, &start, &end)) { /* Extract the selected text */ str = gtk_text_iter_get_visible_text (&start, &end); } if (str) { gtk_selection_data_set_text (selection_data, str, -1); g_free (str); } } } static void gtk_text_view_drag_data_delete (GtkWidget *widget, GdkDragContext *context) { gtk_text_buffer_delete_selection (GTK_TEXT_VIEW (widget)->buffer, TRUE, GTK_TEXT_VIEW (widget)->editable); } static void gtk_text_view_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time) { GtkTextView *text_view; text_view = GTK_TEXT_VIEW (widget); gtk_text_mark_set_visible (text_view->dnd_mark, FALSE); if (text_view->scroll_timeout != 0) g_source_remove (text_view->scroll_timeout); text_view->scroll_timeout = 0; } static gboolean gtk_text_view_drag_motion (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time) { GtkTextIter newplace; GtkTextView *text_view; GtkTextIter start; GtkTextIter end; GdkRectangle target_rect; gint bx, by; GdkAtom target; GdkDragAction suggested_action = 0; text_view = GTK_TEXT_VIEW (widget); target_rect = text_view->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)) return FALSE; /* outside the text window, allow parent widgets to handle event */ gtk_text_view_window_to_buffer_coords (text_view, GTK_TEXT_WINDOW_WIDGET, x, y, &bx, &by); gtk_text_layout_get_iter_at_pixel (text_view->layout, &newplace, bx, by); target = gtk_drag_dest_find_target (widget, context, gtk_drag_dest_get_target_list (widget)); if (target == GDK_NONE) { /* can't accept any of the offered targets */ } else 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 { if (gtk_text_iter_can_insert (&newplace, text_view->editable)) { GtkWidget *source_widget; suggested_action = gdk_drag_context_get_suggested_action (context); source_widget = gtk_drag_get_source_widget (context); if (source_widget == widget) { /* Default to MOVE, unless the user has * pressed ctrl or alt to affect available actions */ if ((gdk_drag_context_get_actions (context) & GDK_ACTION_MOVE) != 0) suggested_action = GDK_ACTION_MOVE; } } else { /* Can't drop here. */ } } if (suggested_action != 0) { gtk_text_mark_set_visible (text_view->dnd_mark, text_view->cursor_visible); gdk_drag_status (context, suggested_action, time); } else { gdk_drag_status (context, 0, time); gtk_text_mark_set_visible (text_view->dnd_mark, FALSE); } if (!text_view->scroll_timeout) text_view->scroll_timeout = gdk_threads_add_timeout (100, drag_scan_timeout, text_view); /* TRUE return means don't propagate the drag motion to parent * widgets that may also be drop sites. */ return TRUE; } static gboolean gtk_text_view_drag_drop (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time) { GtkTextView *text_view; GtkTextIter drop_point; GdkAtom target = GDK_NONE; text_view = GTK_TEXT_VIEW (widget); if (text_view->scroll_timeout != 0) g_source_remove (text_view->scroll_timeout); text_view->scroll_timeout = 0; gtk_text_mark_set_visible (text_view->dnd_mark, FALSE); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &drop_point, text_view->dnd_mark); if (gtk_text_iter_can_insert (&drop_point, text_view->editable)) target = gtk_drag_dest_find_target (widget, context, NULL); if (target != GDK_NONE) gtk_drag_get_data (widget, context, target, time); else gtk_drag_finish (context, FALSE, FALSE, time); return TRUE; } static void insert_text_data (GtkTextView *text_view, GtkTextIter *drop_point, GtkSelectionData *selection_data) { guchar *str; str = gtk_selection_data_get_text (selection_data); if (str) { if (!gtk_text_buffer_insert_interactive (get_buffer (text_view), drop_point, (gchar *) str, -1, text_view->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } g_free (str); } } static void gtk_text_view_drag_data_received (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time) { GtkTextIter drop_point; GtkTextView *text_view; gboolean success = FALSE; GtkTextBuffer *buffer = NULL; text_view = GTK_TEXT_VIEW (widget); if (!text_view->dnd_mark) goto done; buffer = get_buffer (text_view); gtk_text_buffer_get_iter_at_mark (buffer, &drop_point, text_view->dnd_mark); if (!gtk_text_iter_can_insert (&drop_point, text_view->editable)) goto done; success = TRUE; gtk_text_buffer_begin_user_action (buffer); if (info == GTK_TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS) { GtkTextBuffer *src_buffer = NULL; GtkTextIter start, end; gboolean copy_tags = TRUE; if (selection_data->length != sizeof (src_buffer)) return; memcpy (&src_buffer, selection_data->data, sizeof (src_buffer)); if (src_buffer == NULL) return; g_return_if_fail (GTK_IS_TEXT_BUFFER (src_buffer)); if (gtk_text_buffer_get_tag_table (src_buffer) != gtk_text_buffer_get_tag_table (buffer)) { /* try to find a suitable rich text target instead */ GdkAtom *atoms; gint n_atoms; GList *list; GdkAtom target = GDK_NONE; copy_tags = FALSE; atoms = gtk_text_buffer_get_deserialize_formats (buffer, &n_atoms); for (list = gdk_drag_context_list_targets (context); list; list = g_list_next (list)) { gint i; for (i = 0; i < n_atoms; i++) if (GUINT_TO_POINTER (atoms[i]) == list->data) { target = atoms[i]; break; } } g_free (atoms); if (target != GDK_NONE) { gtk_drag_get_data (widget, context, target, time); gtk_text_buffer_end_user_action (buffer); return; } } if (gtk_text_buffer_get_selection_bounds (src_buffer, &start, &end)) { if (copy_tags) gtk_text_buffer_insert_range_interactive (buffer, &drop_point, &start, &end, text_view->editable); else { gchar *str; str = gtk_text_iter_get_visible_text (&start, &end); gtk_text_buffer_insert_interactive (buffer, &drop_point, str, -1, text_view->editable); g_free (str); } } } else if (selection_data->length > 0 && info == GTK_TEXT_BUFFER_TARGET_INFO_RICH_TEXT) { gboolean retval; GError *error = NULL; retval = gtk_text_buffer_deserialize (buffer, buffer, selection_data->target, &drop_point, (guint8 *) selection_data->data, selection_data->length, &error); if (!retval) { g_warning ("error pasting: %s\n", error->message); g_clear_error (&error); } } else insert_text_data (text_view, &drop_point, selection_data); done: gtk_drag_finish (context, success, success && gdk_drag_context_get_selected_action (context) == GDK_ACTION_MOVE, time); if (success) { gtk_text_buffer_get_iter_at_mark (buffer, &drop_point, text_view->dnd_mark); gtk_text_buffer_place_cursor (buffer, &drop_point); gtk_text_buffer_end_user_action (buffer); } } /** * gtk_text_view_get_hadjustment: * @text_view: a #GtkTextView * * Gets the horizontal-scrolling #GtkAdjustment. * * Returns: (transfer none): pointer to the horizontal #GtkAdjustment * * Since: 2.22 **/ GtkAdjustment* gtk_text_view_get_hadjustment (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); return get_hadjustment (text_view); } /** * gtk_text_view_get_vadjustment: * @text_view: a #GtkTextView * * Gets the vertical-scrolling #GtkAdjustment. * * Returns: (transfer none): pointer to the vertical #GtkAdjustment * * Since: 2.22 **/ GtkAdjustment* gtk_text_view_get_vadjustment (GtkTextView *text_view) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); return get_vadjustment (text_view); } static GtkAdjustment* get_hadjustment (GtkTextView *text_view) { if (text_view->hadjustment == NULL) gtk_text_view_set_scroll_adjustments (text_view, NULL, /* forces creation */ text_view->vadjustment); return text_view->hadjustment; } static GtkAdjustment* get_vadjustment (GtkTextView *text_view) { if (text_view->vadjustment == NULL) gtk_text_view_set_scroll_adjustments (text_view, text_view->hadjustment, NULL); /* forces creation */ return text_view->vadjustment; } static void gtk_text_view_set_scroll_adjustments (GtkTextView *text_view, GtkAdjustment *hadj, GtkAdjustment *vadj) { gboolean need_adjust = FALSE; if (hadj) g_return_if_fail (GTK_IS_ADJUSTMENT (hadj)); else hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0)); if (vadj) g_return_if_fail (GTK_IS_ADJUSTMENT (vadj)); else vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0)); if (text_view->hadjustment && (text_view->hadjustment != hadj)) { g_signal_handlers_disconnect_by_func (text_view->hadjustment, gtk_text_view_value_changed, text_view); g_object_unref (text_view->hadjustment); } if (text_view->vadjustment && (text_view->vadjustment != vadj)) { g_signal_handlers_disconnect_by_func (text_view->vadjustment, gtk_text_view_value_changed, text_view); g_object_unref (text_view->vadjustment); } if (text_view->hadjustment != hadj) { text_view->hadjustment = hadj; g_object_ref_sink (text_view->hadjustment); g_signal_connect (text_view->hadjustment, "value-changed", G_CALLBACK (gtk_text_view_value_changed), text_view); need_adjust = TRUE; } if (text_view->vadjustment != vadj) { text_view->vadjustment = vadj; g_object_ref_sink (text_view->vadjustment); g_signal_connect (text_view->vadjustment, "value-changed", G_CALLBACK (gtk_text_view_value_changed), text_view); need_adjust = TRUE; } if (need_adjust) gtk_text_view_value_changed (NULL, text_view); } /* FIXME this adjust_allocation is a big cut-and-paste from * GtkCList, needs to be some "official" way to do this * factored out. */ typedef struct { GdkWindow *window; int dx; int dy; } ScrollData; /* The window to which widget->window is relative */ #define ALLOCATION_WINDOW(widget) \ (!gtk_widget_get_has_window (widget) ? \ (widget)->window : \ gdk_window_get_parent ((widget)->window)) static void adjust_allocation_recurse (GtkWidget *widget, gpointer data) { ScrollData *scroll_data = data; /* Need to really size allocate instead of just poking * into widget->allocation if the widget is not realized. * FIXME someone figure out why this was. */ if (!gtk_widget_get_realized (widget)) { if (gtk_widget_get_visible (widget)) { GdkRectangle tmp_rectangle = widget->allocation; tmp_rectangle.x += scroll_data->dx; tmp_rectangle.y += scroll_data->dy; gtk_widget_size_allocate (widget, &tmp_rectangle); } } else { if (ALLOCATION_WINDOW (widget) == scroll_data->window) { widget->allocation.x += scroll_data->dx; widget->allocation.y += scroll_data->dy; if (GTK_IS_CONTAINER (widget)) gtk_container_forall (GTK_CONTAINER (widget), adjust_allocation_recurse, data); } } } static void adjust_allocation (GtkWidget *widget, int dx, int dy) { ScrollData scroll_data; if (gtk_widget_get_realized (widget)) scroll_data.window = ALLOCATION_WINDOW (widget); else scroll_data.window = NULL; scroll_data.dx = dx; scroll_data.dy = dy; adjust_allocation_recurse (widget, &scroll_data); } static void gtk_text_view_value_changed (GtkAdjustment *adj, GtkTextView *text_view) { GtkTextIter iter; gint line_top; gint dx = 0; gint dy = 0; /* Note that we oddly call this function with adj == NULL * sometimes */ text_view->onscreen_validated = FALSE; DV(g_print(">Scroll offset changed %s/%g, onscreen_validated = FALSE ("G_STRLOC")\n", adj == text_view->hadjustment ? "hadj" : adj == text_view->vadjustment ? "vadj" : "none", adj ? adj->value : 0.0)); if (adj == text_view->hadjustment) { dx = text_view->xoffset - (gint)adj->value; text_view->xoffset = adj->value; /* If the change is due to a size change we need * to invalidate the entire text window because there might be * right-aligned or centered text */ if (text_view->width_changed) { if (gtk_widget_get_realized (GTK_WIDGET (text_view))) gdk_window_invalidate_rect (text_view->text_window->bin_window, NULL, FALSE); text_view->width_changed = FALSE; } } else if (adj == text_view->vadjustment) { dy = text_view->yoffset - (gint)adj->value; text_view->yoffset = adj->value; if (text_view->layout) { gtk_text_layout_get_line_at_y (text_view->layout, &iter, adj->value, &line_top); gtk_text_buffer_move_mark (get_buffer (text_view), text_view->first_para_mark, &iter); text_view->first_para_pixels = adj->value - line_top; } } if (dx != 0 || dy != 0) { GSList *tmp_list; if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { if (dy != 0) { if (text_view->left_window) text_window_scroll (text_view->left_window, 0, dy); if (text_view->right_window) text_window_scroll (text_view->right_window, 0, dy); } if (dx != 0) { if (text_view->top_window) text_window_scroll (text_view->top_window, dx, 0); if (text_view->bottom_window) text_window_scroll (text_view->bottom_window, dx, 0); } /* It looks nicer to scroll the main area last, because * it takes a while, and making the side areas update * afterward emphasizes the slowness of scrolling the * main area. */ text_window_scroll (text_view->text_window, dx, dy); } /* Children are now "moved" in the text window, poke * into widget->allocation for each child */ tmp_list = text_view->children; while (tmp_list != NULL) { GtkTextViewChild *child = tmp_list->data; if (child->anchor) adjust_allocation (child->widget, dx, dy); tmp_list = g_slist_next (tmp_list); } } /* 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); /* process exposes */ if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { DV (g_print ("Processing updates (%s)\n", G_STRLOC)); if (text_view->left_window) gdk_window_process_updates (text_view->left_window->bin_window, TRUE); if (text_view->right_window) gdk_window_process_updates (text_view->right_window->bin_window, TRUE); if (text_view->top_window) gdk_window_process_updates (text_view->top_window->bin_window, TRUE); if (text_view->bottom_window) gdk_window_process_updates (text_view->bottom_window->bin_window, TRUE); gdk_window_process_updates (text_view->text_window->bin_window, TRUE); } /* If this got installed, get rid of it, it's just a waste of time. */ if (text_view->first_validate_idle != 0) { g_source_remove (text_view->first_validate_idle); text_view->first_validate_idle = 0; } /* 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); DV(g_print(">End scroll offset changed handler ("G_STRLOC")\n")); } static void gtk_text_view_commit_handler (GtkIMContext *context, const gchar *str, GtkTextView *text_view) { gtk_text_view_commit_text (text_view, str); } static void gtk_text_view_commit_text (GtkTextView *text_view, const gchar *str) { gboolean had_selection; 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, text_view->editable); if (!strcmp (str, "\n")) { if (!gtk_text_buffer_insert_interactive_at_cursor (get_buffer (text_view), "\n", 1, text_view->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); } } else { if (!had_selection && text_view->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, text_view->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) { gchar *str; PangoAttrList *attrs; gint cursor_pos; GtkTextIter iter; gtk_text_buffer_get_iter_at_mark (text_view->buffer, &iter, gtk_text_buffer_get_insert (text_view->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 key-press-event handler. */ gtk_im_context_get_preedit_string (context, &str, &attrs, &cursor_pos); if (str && str[0] && !gtk_text_iter_can_insert (&iter, text_view->editable)) { gtk_widget_error_bell (GTK_WIDGET (text_view)); goto out; } g_signal_emit (text_view, signals[PREEDIT_CHANGED], 0, str); if (text_view->layout) gtk_text_layout_set_preedit_string (text_view->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; gint pos; gchar *text; gtk_text_buffer_get_iter_at_mark (text_view->buffer, &start, gtk_text_buffer_get_insert (text_view->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, gint offset, gint n_chars, GtkTextView *text_view) { GtkTextIter start; GtkTextIter end; gtk_text_buffer_get_iter_at_mark (text_view->buffer, &start, gtk_text_buffer_get_insert (text_view->buffer)); end = start; gtk_text_iter_forward_chars (&start, offset); gtk_text_iter_forward_chars (&end, offset + n_chars); gtk_text_buffer_delete_interactive (text_view->buffer, &start, &end, text_view->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; if (mark == gtk_text_buffer_get_insert (buffer)) { text_view->virtual_cursor_x = -1; text_view->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); } static void gtk_text_view_target_list_notify (GtkTextBuffer *buffer, const GParamSpec *pspec, gpointer data) { GtkWidget *widget = GTK_WIDGET (data); GtkTargetList *view_list; GtkTargetList *buffer_list; GList *list; view_list = gtk_drag_dest_get_target_list (widget); buffer_list = gtk_text_buffer_get_paste_target_list (buffer); if (view_list) gtk_target_list_ref (view_list); else view_list = gtk_target_list_new (NULL, 0); list = view_list->list; while (list) { GtkTargetPair *pair = list->data; list = g_list_next (list); /* get next element before removing */ if (pair->info >= GTK_TEXT_BUFFER_TARGET_INFO_TEXT && pair->info <= GTK_TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS) { gtk_target_list_remove (view_list, pair->target); } } for (list = buffer_list->list; list; list = g_list_next (list)) { GtkTargetPair *pair = list->data; gtk_target_list_add (view_list, pair->target, pair->flags, pair->info); } gtk_drag_dest_set_target_list (widget, view_list); gtk_target_list_unref (view_list); } static void gtk_text_view_get_cursor_location (GtkTextView *text_view, GdkRectangle *pos) { 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_layout_get_cursor_locations (text_view->layout, &insert, pos, NULL); } static void gtk_text_view_get_virtual_cursor_pos (GtkTextView *text_view, GtkTextIter *cursor, gint *x, gint *y) { GtkTextIter insert; GdkRectangle pos; 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 && text_view->virtual_cursor_x == -1) || (y && text_view->virtual_cursor_y == -1)) gtk_text_layout_get_cursor_locations (text_view->layout, &insert, &pos, NULL); if (x) { if (text_view->virtual_cursor_x != -1) *x = text_view->virtual_cursor_x; else *x = pos.x; } if (y) { if (text_view->virtual_cursor_x != -1) *y = text_view->virtual_cursor_y; else *y = pos.y + pos.height / 2; } } static void gtk_text_view_set_virtual_cursor_pos (GtkTextView *text_view, gint x, gint y) { GdkRectangle pos; if (!text_view->layout) return; if (x == -1 || y == -1) gtk_text_view_get_cursor_location (text_view, &pos); text_view->virtual_cursor_x = (x == -1) ? pos.x : x; text_view->virtual_cursor_y = (y == -1) ? pos.y + pos.height / 2 : y; } /* Quick hack of a popup menu */ static void activate_cb (GtkWidget *menuitem, GtkTextView *text_view) { const gchar *signal = g_object_get_data (G_OBJECT (menuitem), "gtk-signal"); g_signal_emit_by_name (text_view, signal); } static void append_action_signal (GtkTextView *text_view, GtkWidget *menu, const gchar *stock_id, const gchar *signal, gboolean sensitive) { GtkWidget *menuitem = gtk_image_menu_item_new_from_stock (stock_id, NULL); g_object_set_data (G_OBJECT (menuitem), I_("gtk-signal"), (char *)signal); g_signal_connect (menuitem, "activate", G_CALLBACK (activate_cb), text_view); gtk_widget_set_sensitive (menuitem, sensitive); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem); } 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->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 void select_all_cb (GtkWidget *menuitem, GtkTextView *text_view) { gtk_text_view_select_all (GTK_WIDGET (text_view), TRUE); } static void delete_cb (GtkTextView *text_view) { gtk_text_buffer_delete_selection (get_buffer (text_view), TRUE, text_view->editable); } static void popup_menu_detach (GtkWidget *attach_widget, GtkMenu *menu) { GTK_TEXT_VIEW (attach_widget)->popup_menu = NULL; } static void popup_position_func (GtkMenu *menu, gint *x, gint *y, gboolean *push_in, gpointer user_data) { GtkTextView *text_view; GtkWidget *widget; GdkRectangle cursor_rect; GdkRectangle onscreen_rect; gint root_x, root_y; GtkTextIter iter; GtkRequisition req; GdkScreen *screen; gint monitor_num; GdkRectangle monitor; text_view = GTK_TEXT_VIEW (user_data); widget = GTK_WIDGET (text_view); g_return_if_fail (gtk_widget_get_realized (widget)); screen = gtk_widget_get_screen (widget); gdk_window_get_origin (widget->window, &root_x, &root_y); gtk_text_buffer_get_iter_at_mark (get_buffer (text_view), &iter, gtk_text_buffer_get_insert (get_buffer (text_view))); gtk_text_view_get_iter_location (text_view, &iter, &cursor_rect); gtk_text_view_get_visible_rect (text_view, &onscreen_rect); gtk_widget_size_request (text_view->popup_menu, &req); /* can't use rectangle_intersect since cursor rect can have 0 width */ if (cursor_rect.x >= onscreen_rect.x && cursor_rect.x < onscreen_rect.x + onscreen_rect.width && cursor_rect.y >= onscreen_rect.y && cursor_rect.y < onscreen_rect.y + onscreen_rect.height) { gtk_text_view_buffer_to_window_coords (text_view, GTK_TEXT_WINDOW_WIDGET, cursor_rect.x, cursor_rect.y, &cursor_rect.x, &cursor_rect.y); *x = root_x + cursor_rect.x + cursor_rect.width; *y = root_y + cursor_rect.y + cursor_rect.height; } else { /* Just center the menu, since cursor is offscreen. */ *x = root_x + (widget->allocation.width / 2 - req.width / 2); *y = root_y + (widget->allocation.height / 2 - req.height / 2); } /* Ensure sanity */ *x = CLAMP (*x, root_x, (root_x + widget->allocation.width)); *y = CLAMP (*y, root_y, (root_y + widget->allocation.height)); monitor_num = gdk_screen_get_monitor_at_point (screen, *x, *y); gtk_menu_set_monitor (menu, monitor_num); gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor); *x = CLAMP (*x, monitor.x, monitor.x + MAX (0, monitor.width - req.width)); *y = CLAMP (*y, monitor.y, monitor.y + MAX (0, monitor.height - req.height)); *push_in = FALSE; } typedef struct { GtkTextView *text_view; gint button; guint time; } PopupInfo; 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 unichar_chosen_func (const char *text, gpointer data) { GtkTextView *text_view = GTK_TEXT_VIEW (data); gtk_text_view_commit_text (text_view, text); } static void popup_targets_received (GtkClipboard *clipboard, GtkSelectionData *data, gpointer user_data) { PopupInfo *info = user_data; GtkTextView *text_view = info->text_view; if (gtk_widget_get_realized (GTK_WIDGET (text_view))) { /* We implicitely rely here on the fact that if we are pasting ourself, we'll * have text targets as well as the private GTK_TEXT_BUFFER_CONTENTS target. */ gboolean clipboard_contains_text; GtkWidget *menuitem; GtkWidget *submenu; gboolean have_selection; gboolean can_insert; GtkTextIter iter; GtkTextIter sel_start, sel_end; gboolean show_input_method_menu; gboolean show_unicode_menu; clipboard_contains_text = gtk_selection_data_targets_include_text (data); if (text_view->popup_menu) gtk_widget_destroy (text_view->popup_menu); text_view->popup_menu = gtk_menu_new (); gtk_menu_attach_to_widget (GTK_MENU (text_view->popup_menu), GTK_WIDGET (text_view), popup_menu_detach); 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, text_view->editable); append_action_signal (text_view, text_view->popup_menu, GTK_STOCK_CUT, "cut-clipboard", have_selection && range_contains_editable_text (&sel_start, &sel_end, text_view->editable)); append_action_signal (text_view, text_view->popup_menu, GTK_STOCK_COPY, "copy-clipboard", have_selection); append_action_signal (text_view, text_view->popup_menu, GTK_STOCK_PASTE, "paste-clipboard", can_insert && clipboard_contains_text); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_DELETE, NULL); gtk_widget_set_sensitive (menuitem, have_selection && range_contains_editable_text (&sel_start, &sel_end, text_view->editable)); g_signal_connect_swapped (menuitem, "activate", G_CALLBACK (delete_cb), text_view); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_SELECT_ALL, NULL); g_signal_connect (menuitem, "activate", G_CALLBACK (select_all_cb), text_view); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); g_object_get (gtk_widget_get_settings (GTK_WIDGET (text_view)), "gtk-show-input-method-menu", &show_input_method_menu, "gtk-show-unicode-menu", &show_unicode_menu, NULL); if (show_input_method_menu || show_unicode_menu) { menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); } if (show_input_method_menu) { menuitem = gtk_menu_item_new_with_mnemonic (_("Input _Methods")); gtk_widget_show (menuitem); gtk_widget_set_sensitive (menuitem, can_insert); submenu = gtk_menu_new (); gtk_menu_item_set_submenu (GTK_MENU_ITEM (menuitem), submenu); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); gtk_im_multicontext_append_menuitems (GTK_IM_MULTICONTEXT (text_view->im_context), GTK_MENU_SHELL (submenu)); } if (show_unicode_menu) { menuitem = gtk_menu_item_new_with_mnemonic (_("_Insert Unicode Control Character")); gtk_widget_show (menuitem); gtk_widget_set_sensitive (menuitem, can_insert); submenu = gtk_menu_new (); gtk_menu_item_set_submenu (GTK_MENU_ITEM (menuitem), submenu); gtk_menu_shell_append (GTK_MENU_SHELL (text_view->popup_menu), menuitem); _gtk_text_util_append_special_char_menuitems (GTK_MENU_SHELL (submenu), unichar_chosen_func, text_view); } g_signal_emit (text_view, signals[POPULATE_POPUP], 0, text_view->popup_menu); if (info->button) gtk_menu_popup (GTK_MENU (text_view->popup_menu), NULL, NULL, NULL, NULL, info->button, info->time); else { gtk_menu_popup (GTK_MENU (text_view->popup_menu), NULL, NULL, popup_position_func, text_view, 0, gtk_get_current_event_time ()); gtk_menu_shell_select_first (GTK_MENU_SHELL (text_view->popup_menu), FALSE); } } g_object_unref (text_view); g_free (info); } static void gtk_text_view_do_popup (GtkTextView *text_view, GdkEventButton *event) { PopupInfo *info = g_new (PopupInfo, 1); /* In order to know what entries we should make sensitive, we * ask for the current targets of the clipboard, and when * we get them, then we actually pop up the menu. */ info->text_view = g_object_ref (text_view); if (event) { info->button = event->button; info->time = event->time; } else { info->button = 0; info->time = gtk_get_current_event_time (); } gtk_clipboard_request_contents (gtk_widget_get_clipboard (GTK_WIDGET (text_view), GDK_SELECTION_CLIPBOARD), gdk_atom_intern_static_string ("TARGETS"), popup_targets_received, info); } static gboolean gtk_text_view_popup_menu (GtkWidget *widget) { gtk_text_view_do_popup (GTK_TEXT_VIEW (widget), NULL); return TRUE; } /* Child GdkWindows */ static GtkTextWindow* text_window_new (GtkTextWindowType type, GtkWidget *widget, gint width_request, gint height_request) { GtkTextWindow *win; win = g_new (GtkTextWindow, 1); win->type = type; win->widget = widget; win->window = NULL; win->bin_window = NULL; win->requisition.width = width_request; win->requisition.height = height_request; win->allocation.width = width_request; win->allocation.height = height_request; win->allocation.x = 0; win->allocation.y = 0; return win; } static void text_window_free (GtkTextWindow *win) { if (win->window) text_window_unrealize (win); g_free (win); } static void text_window_realize (GtkTextWindow *win, GtkWidget *widget) { GdkWindowAttr attributes; gint attributes_mask; GdkCursor *cursor; attributes.window_type = GDK_WINDOW_CHILD; attributes.x = win->allocation.x; attributes.y = win->allocation.y; attributes.width = win->allocation.width; attributes.height = win->allocation.height; attributes.wclass = GDK_INPUT_OUTPUT; attributes.visual = gtk_widget_get_visual (win->widget); attributes.colormap = gtk_widget_get_colormap (win->widget); attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK; attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP; win->window = gdk_window_new (widget->window, &attributes, attributes_mask); gdk_window_set_back_pixmap (win->window, NULL, FALSE); gdk_window_show (win->window); gdk_window_set_user_data (win->window, win->widget); gdk_window_lower (win->window); attributes.x = 0; attributes.y = 0; attributes.width = win->allocation.width; attributes.height = win->allocation.height; attributes.event_mask = (GDK_EXPOSURE_MASK | GDK_SCROLL_MASK | GDK_KEY_PRESS_MASK | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK | GDK_POINTER_MOTION_MASK | GDK_POINTER_MOTION_HINT_MASK | gtk_widget_get_events (win->widget)); win->bin_window = gdk_window_new (win->window, &attributes, attributes_mask); gdk_window_show (win->bin_window); gdk_window_set_user_data (win->bin_window, win->widget); if (win->type == GTK_TEXT_WINDOW_TEXT) { if (gtk_widget_is_sensitive (widget)) { /* I-beam cursor */ cursor = gdk_cursor_new_for_display (gdk_window_get_display (widget->window), GDK_XTERM); gdk_window_set_cursor (win->bin_window, cursor); gdk_cursor_unref (cursor); } gtk_im_context_set_client_window (GTK_TEXT_VIEW (widget)->im_context, win->window); gdk_window_set_background (win->bin_window, &widget->style->base[gtk_widget_get_state (widget)]); } else { gdk_window_set_background (win->bin_window, &widget->style->bg[gtk_widget_get_state (widget)]); } g_object_set_qdata (G_OBJECT (win->window), g_quark_from_static_string ("gtk-text-view-text-window"), win); g_object_set_qdata (G_OBJECT (win->bin_window), g_quark_from_static_string ("gtk-text-view-text-window"), win); } static void text_window_unrealize (GtkTextWindow *win) { if (win->type == GTK_TEXT_WINDOW_TEXT) { gtk_im_context_set_client_window (GTK_TEXT_VIEW (win->widget)->im_context, NULL); } gdk_window_set_user_data (win->window, NULL); gdk_window_set_user_data (win->bin_window, NULL); gdk_window_destroy (win->bin_window); gdk_window_destroy (win->window); win->window = NULL; win->bin_window = NULL; } static void text_window_size_allocate (GtkTextWindow *win, GdkRectangle *rect) { win->allocation = *rect; if (win->window) { gdk_window_move_resize (win->window, rect->x, rect->y, rect->width, rect->height); gdk_window_resize (win->bin_window, rect->width, rect->height); } } static void text_window_scroll (GtkTextWindow *win, gint dx, gint dy) { if (dx != 0 || dy != 0) { gdk_window_scroll (win->bin_window, dx, dy); } } static void text_window_invalidate_rect (GtkTextWindow *win, GdkRectangle *rect) { GdkRectangle window_rect; gtk_text_view_buffer_to_window_coords (GTK_TEXT_VIEW (win->widget), win->type, rect->x, rect->y, &window_rect.x, &window_rect.y); window_rect.width = rect->width; window_rect.height = rect->height; /* Adjust the rect as appropriate */ switch (win->type) { case GTK_TEXT_WINDOW_TEXT: break; case GTK_TEXT_WINDOW_LEFT: case GTK_TEXT_WINDOW_RIGHT: window_rect.x = 0; window_rect.width = win->allocation.width; break; case GTK_TEXT_WINDOW_TOP: case GTK_TEXT_WINDOW_BOTTOM: window_rect.y = 0; window_rect.height = win->allocation.height; break; default: g_warning ("%s: bug!", G_STRFUNC); return; break; } gdk_window_invalidate_rect (win->bin_window, &window_rect, FALSE); #if 0 { cairo_t *cr = gdk_cairo_create (win->bin_window); gdk_cairo_rectangle (cr, &window_rect); cairo_set_source_rgb (cr, 1.0, 0.0, 0.0); /* red */ cairo_fill (cr); cairo_destroy (cr); } #endif } static void text_window_invalidate_cursors (GtkTextWindow *win) { GtkTextView *text_view = GTK_TEXT_VIEW (win->widget); GtkTextIter iter; GdkRectangle strong; GdkRectangle weak; gboolean draw_arrow; gfloat cursor_aspect_ratio; gint stem_width; gint arrow_width; gtk_text_buffer_get_iter_at_mark (text_view->buffer, &iter, gtk_text_buffer_get_insert (text_view->buffer)); if (_gtk_text_layout_get_block_cursor (text_view->layout, &strong)) { text_window_invalidate_rect (win, &strong); return; } gtk_text_layout_get_cursor_locations (text_view->layout, &iter, &strong, &weak); /* cursor width calculation as in gtkstyle.c:draw_insertion_cursor(), * ignoring the text direction be exposing both sides of the cursor */ draw_arrow = (strong.x != weak.x || strong.y != weak.y); gtk_widget_style_get (win->widget, "cursor-aspect-ratio", &cursor_aspect_ratio, NULL); stem_width = strong.height * cursor_aspect_ratio + 1; arrow_width = stem_width + 1; strong.width = stem_width; /* round up to the next even number */ if (stem_width & 1) stem_width++; strong.x -= stem_width / 2; strong.width += stem_width; if (draw_arrow) { strong.x -= arrow_width; strong.width += arrow_width * 2; } text_window_invalidate_rect (win, &strong); if (draw_arrow) /* == have weak */ { stem_width = weak.height * cursor_aspect_ratio + 1; arrow_width = stem_width + 1; weak.width = stem_width; /* round up to the next even number */ if (stem_width & 1) stem_width++; weak.x -= stem_width / 2; weak.width += stem_width; weak.x -= arrow_width; weak.width += arrow_width * 2; text_window_invalidate_rect (win, &weak); } } static gint text_window_get_width (GtkTextWindow *win) { return win->allocation.width; } static gint text_window_get_height (GtkTextWindow *win) { return win->allocation.height; } /* Windows */ /** * gtk_text_view_get_window: * @text_view: a #GtkTextView * @win: window to get * * Retrieves the #GdkWindow corresponding to an area of the text view; * possible windows include the overall widget window, child windows * on the left, right, top, bottom, and the window that displays the * text buffer. Windows are %NULL and nonexistent if their width or * height is 0, and are nonexistent before the widget has been * realized. * * Return value: (transfer none): a #GdkWindow, or %NULL **/ GdkWindow* gtk_text_view_get_window (GtkTextView *text_view, GtkTextWindowType win) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), NULL); switch (win) { case GTK_TEXT_WINDOW_WIDGET: return GTK_WIDGET (text_view)->window; break; case GTK_TEXT_WINDOW_TEXT: return text_view->text_window->bin_window; break; case GTK_TEXT_WINDOW_LEFT: if (text_view->left_window) return text_view->left_window->bin_window; else return NULL; break; case GTK_TEXT_WINDOW_RIGHT: if (text_view->right_window) return text_view->right_window->bin_window; else return NULL; break; case GTK_TEXT_WINDOW_TOP: if (text_view->top_window) return text_view->top_window->bin_window; else return NULL; break; case GTK_TEXT_WINDOW_BOTTOM: if (text_view->bottom_window) return text_view->bottom_window->bin_window; else return NULL; break; case GTK_TEXT_WINDOW_PRIVATE: g_warning ("%s: You can't get GTK_TEXT_WINDOW_PRIVATE, it has \"PRIVATE\" in the name because it is private.", G_STRFUNC); return NULL; break; } g_warning ("%s: Unknown GtkTextWindowType", G_STRFUNC); return NULL; } /** * gtk_text_view_get_window_type: * @text_view: a #GtkTextView * @window: a window type * * Usually used to find out which window an event corresponds to. * If you connect to an event signal on @text_view, this function * should be called on event->window to * see which window it was. * * Return value: the window type. **/ GtkTextWindowType gtk_text_view_get_window_type (GtkTextView *text_view, GdkWindow *window) { GtkTextWindow *win; g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); g_return_val_if_fail (GDK_IS_WINDOW (window), 0); if (window == GTK_WIDGET (text_view)->window) return GTK_TEXT_WINDOW_WIDGET; win = g_object_get_qdata (G_OBJECT (window), g_quark_try_string ("gtk-text-view-text-window")); if (win) return win->type; else { return GTK_TEXT_WINDOW_PRIVATE; } } static void buffer_to_widget (GtkTextView *text_view, gint buffer_x, gint buffer_y, gint *window_x, gint *window_y) { if (window_x) { *window_x = buffer_x - text_view->xoffset; *window_x += text_view->text_window->allocation.x; } if (window_y) { *window_y = buffer_y - text_view->yoffset; *window_y += text_view->text_window->allocation.y; } } static void widget_to_text_window (GtkTextWindow *win, gint widget_x, gint widget_y, gint *window_x, gint *window_y) { if (window_x) *window_x = widget_x - win->allocation.x; if (window_y) *window_y = widget_y - win->allocation.y; } static void buffer_to_text_window (GtkTextView *text_view, GtkTextWindow *win, gint buffer_x, gint buffer_y, gint *window_x, gint *window_y) { if (win == NULL) { g_warning ("Attempt to convert text buffer coordinates to coordinates " "for a nonexistent or private child window of GtkTextView"); return; } buffer_to_widget (text_view, buffer_x, buffer_y, window_x, window_y); widget_to_text_window (win, window_x ? *window_x : 0, window_y ? *window_y : 0, window_x, window_y); } /** * gtk_text_view_buffer_to_window_coords: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE * @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). * * Note that you can't convert coordinates for a nonexisting window (see * gtk_text_view_set_border_window_size()). **/ void gtk_text_view_buffer_to_window_coords (GtkTextView *text_view, GtkTextWindowType win, gint buffer_x, gint buffer_y, gint *window_x, gint *window_y) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); switch (win) { case GTK_TEXT_WINDOW_WIDGET: buffer_to_widget (text_view, buffer_x, buffer_y, window_x, window_y); break; case GTK_TEXT_WINDOW_TEXT: if (window_x) *window_x = buffer_x - text_view->xoffset; if (window_y) *window_y = buffer_y - text_view->yoffset; break; case GTK_TEXT_WINDOW_LEFT: buffer_to_text_window (text_view, text_view->left_window, buffer_x, buffer_y, window_x, window_y); break; case GTK_TEXT_WINDOW_RIGHT: buffer_to_text_window (text_view, text_view->right_window, buffer_x, buffer_y, window_x, window_y); break; case GTK_TEXT_WINDOW_TOP: buffer_to_text_window (text_view, text_view->top_window, buffer_x, buffer_y, window_x, window_y); break; case GTK_TEXT_WINDOW_BOTTOM: buffer_to_text_window (text_view, text_view->bottom_window, buffer_x, buffer_y, window_x, window_y); break; case GTK_TEXT_WINDOW_PRIVATE: g_warning ("%s: can't get coords for private windows", G_STRFUNC); break; default: g_warning ("%s: Unknown GtkTextWindowType", G_STRFUNC); break; } } static void widget_to_buffer (GtkTextView *text_view, gint widget_x, gint widget_y, gint *buffer_x, gint *buffer_y) { if (buffer_x) { *buffer_x = widget_x + text_view->xoffset; *buffer_x -= text_view->text_window->allocation.x; } if (buffer_y) { *buffer_y = widget_y + text_view->yoffset; *buffer_y -= text_view->text_window->allocation.y; } } static void text_window_to_widget (GtkTextWindow *win, gint window_x, gint window_y, gint *widget_x, gint *widget_y) { if (widget_x) *widget_x = window_x + win->allocation.x; if (widget_y) *widget_y = window_y + win->allocation.y; } static void text_window_to_buffer (GtkTextView *text_view, GtkTextWindow *win, gint window_x, gint window_y, gint *buffer_x, gint *buffer_y) { if (win == NULL) { g_warning ("Attempt to convert GtkTextView buffer coordinates into " "coordinates for a nonexistent child window."); return; } text_window_to_widget (win, window_x, window_y, buffer_x, buffer_y); widget_to_buffer (text_view, buffer_x ? *buffer_x : 0, buffer_y ? *buffer_y : 0, buffer_x, buffer_y); } /** * gtk_text_view_window_to_buffer_coords: * @text_view: a #GtkTextView * @win: a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE * @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). * * Note that you can't convert coordinates for a nonexisting window (see * gtk_text_view_set_border_window_size()). **/ void gtk_text_view_window_to_buffer_coords (GtkTextView *text_view, GtkTextWindowType win, gint window_x, gint window_y, gint *buffer_x, gint *buffer_y) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); switch (win) { case GTK_TEXT_WINDOW_WIDGET: widget_to_buffer (text_view, window_x, window_y, buffer_x, buffer_y); break; case GTK_TEXT_WINDOW_TEXT: if (buffer_x) *buffer_x = window_x + text_view->xoffset; if (buffer_y) *buffer_y = window_y + text_view->yoffset; break; case GTK_TEXT_WINDOW_LEFT: text_window_to_buffer (text_view, text_view->left_window, window_x, window_y, buffer_x, buffer_y); break; case GTK_TEXT_WINDOW_RIGHT: text_window_to_buffer (text_view, text_view->right_window, window_x, window_y, buffer_x, buffer_y); break; case GTK_TEXT_WINDOW_TOP: text_window_to_buffer (text_view, text_view->top_window, window_x, window_y, buffer_x, buffer_y); break; case GTK_TEXT_WINDOW_BOTTOM: text_window_to_buffer (text_view, text_view->bottom_window, window_x, window_y, buffer_x, buffer_y); break; case GTK_TEXT_WINDOW_PRIVATE: g_warning ("%s: can't get coords for private windows", G_STRFUNC); break; default: g_warning ("%s: Unknown GtkTextWindowType", G_STRFUNC); break; } } static void set_window_width (GtkTextView *text_view, gint width, GtkTextWindowType type, GtkTextWindow **winp) { if (width == 0) { if (*winp) { text_window_free (*winp); *winp = NULL; gtk_widget_queue_resize (GTK_WIDGET (text_view)); } } else { if (*winp == NULL) { *winp = text_window_new (type, GTK_WIDGET (text_view), width, 0); /* if the widget is already realized we need to realize the child manually */ if (gtk_widget_get_realized (GTK_WIDGET (text_view))) text_window_realize (*winp, GTK_WIDGET (text_view)); } else { if ((*winp)->requisition.width == width) return; (*winp)->requisition.width = width; } gtk_widget_queue_resize (GTK_WIDGET (text_view)); } } static void set_window_height (GtkTextView *text_view, gint height, GtkTextWindowType type, GtkTextWindow **winp) { if (height == 0) { if (*winp) { text_window_free (*winp); *winp = NULL; gtk_widget_queue_resize (GTK_WIDGET (text_view)); } } else { if (*winp == NULL) { *winp = text_window_new (type, GTK_WIDGET (text_view), 0, height); /* if the widget is already realized we need to realize the child manually */ if (gtk_widget_get_realized (GTK_WIDGET (text_view))) text_window_realize (*winp, GTK_WIDGET (text_view)); } else { if ((*winp)->requisition.height == height) return; (*winp)->requisition.height = height; } gtk_widget_queue_resize (GTK_WIDGET (text_view)); } } /** * gtk_text_view_set_border_window_size: * @text_view: a #GtkTextView * @type: window to affect * @size: width or height of the window * * Sets the width of %GTK_TEXT_WINDOW_LEFT or %GTK_TEXT_WINDOW_RIGHT, * or the height of %GTK_TEXT_WINDOW_TOP or %GTK_TEXT_WINDOW_BOTTOM. * Automatically destroys the corresponding window if the size is set * to 0, and creates the window if the size is set to non-zero. This * function can only be used for the "border windows," it doesn't work * with #GTK_TEXT_WINDOW_WIDGET, #GTK_TEXT_WINDOW_TEXT, or * #GTK_TEXT_WINDOW_PRIVATE. **/ void gtk_text_view_set_border_window_size (GtkTextView *text_view, GtkTextWindowType type, gint size) { g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (size >= 0); switch (type) { case GTK_TEXT_WINDOW_LEFT: set_window_width (text_view, size, GTK_TEXT_WINDOW_LEFT, &text_view->left_window); break; case GTK_TEXT_WINDOW_RIGHT: set_window_width (text_view, size, GTK_TEXT_WINDOW_RIGHT, &text_view->right_window); break; case GTK_TEXT_WINDOW_TOP: set_window_height (text_view, size, GTK_TEXT_WINDOW_TOP, &text_view->top_window); break; case GTK_TEXT_WINDOW_BOTTOM: set_window_height (text_view, size, GTK_TEXT_WINDOW_BOTTOM, &text_view->bottom_window); break; default: g_warning ("Can only set size of left/right/top/bottom border windows with gtk_text_view_set_border_window_size()"); break; } } /** * gtk_text_view_get_border_window_size: * @text_view: a #GtkTextView * @type: window to return size from * * Gets the width of the specified border window. See * gtk_text_view_set_border_window_size(). * * Return value: width of window **/ gint gtk_text_view_get_border_window_size (GtkTextView *text_view, GtkTextWindowType type) { g_return_val_if_fail (GTK_IS_TEXT_VIEW (text_view), 0); switch (type) { case GTK_TEXT_WINDOW_LEFT: if (text_view->left_window) return text_view->left_window->requisition.width; break; case GTK_TEXT_WINDOW_RIGHT: if (text_view->right_window) return text_view->right_window->requisition.width; break; case GTK_TEXT_WINDOW_TOP: if (text_view->top_window) return text_view->top_window->requisition.height; break; case GTK_TEXT_WINDOW_BOTTOM: if (text_view->bottom_window) return text_view->bottom_window->requisition.height; break; default: g_warning ("Can only get size of left/right/top/bottom border windows with gtk_text_view_get_border_window_size()"); break; } return 0; } /* * Child widgets */ static GtkTextViewChild* text_view_child_new_anchored (GtkWidget *child, GtkTextChildAnchor *anchor, GtkTextLayout *layout) { GtkTextViewChild *vc; vc = g_new (GtkTextViewChild, 1); vc->type = GTK_TEXT_WINDOW_PRIVATE; vc->widget = child; vc->anchor = anchor; vc->from_top_of_line = 0; vc->from_left_of_buffer = 0; g_object_ref (vc->widget); g_object_ref (vc->anchor); g_object_set_data (G_OBJECT (child), I_("gtk-text-view-child"), vc); gtk_text_child_anchor_register_child (anchor, child, layout); return vc; } static GtkTextViewChild* text_view_child_new_window (GtkWidget *child, GtkTextWindowType type, gint x, gint y) { GtkTextViewChild *vc; vc = g_new (GtkTextViewChild, 1); vc->widget = child; vc->anchor = NULL; vc->from_top_of_line = 0; vc->from_left_of_buffer = 0; g_object_ref (vc->widget); vc->type = type; vc->x = x; vc->y = y; g_object_set_data (G_OBJECT (child), I_("gtk-text-view-child"), vc); return vc; } static void text_view_child_free (GtkTextViewChild *child) { g_object_set_data (G_OBJECT (child->widget), I_("gtk-text-view-child"), NULL); if (child->anchor) { gtk_text_child_anchor_unregister_child (child->anchor, child->widget); g_object_unref (child->anchor); } g_object_unref (child->widget); g_free (child); } static void text_view_child_set_parent_window (GtkTextView *text_view, GtkTextViewChild *vc) { if (vc->anchor) gtk_widget_set_parent_window (vc->widget, text_view->text_window->bin_window); else { GdkWindow *window; window = gtk_text_view_get_window (text_view, vc->type); gtk_widget_set_parent_window (vc->widget, window); } } static void add_child (GtkTextView *text_view, GtkTextViewChild *vc) { text_view->children = g_slist_prepend (text_view->children, vc); if (gtk_widget_get_realized (GTK_WIDGET (text_view))) text_view_child_set_parent_window (text_view, vc); 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) { GtkTextViewChild *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 (child->parent == NULL); gtk_text_view_ensure_layout (text_view); vc = text_view_child_new_anchored (child, anchor, text_view->layout); add_child (text_view, vc); g_assert (vc->widget == child); g_assert (gtk_widget_get_parent (child) == GTK_WIDGET (text_view)); } /** * gtk_text_view_add_child_in_window: * @text_view: a #GtkTextView * @child: a #GtkWidget * @which_window: which window the child should appear in * @xpos: X position of child in window coordinates * @ypos: Y position of child in window coordinates * * Adds a child at fixed coordinates in one of the text widget's * windows. The window must have nonzero size (see * gtk_text_view_set_border_window_size()). Note that the child * coordinates are given relative to the #GdkWindow in question, and * that these coordinates have no sane relationship to scrolling. When * placing a child in #GTK_TEXT_WINDOW_WIDGET, scrolling is * irrelevant, the child floats above all scrollable areas. But when * placing a child in one of the scrollable windows (border windows or * text window), you'll need to compute the child's correct position * in buffer coordinates any time scrolling occurs or buffer changes * occur, and then call gtk_text_view_move_child() to update the * child's position. Unfortunately there's no good way to detect that * scrolling has occurred, using the current API; a possible hack * would be to update all child positions when the scroll adjustments * change or the text buffer changes. See bug 64518 on * bugzilla.gnome.org for status of fixing this issue. **/ void gtk_text_view_add_child_in_window (GtkTextView *text_view, GtkWidget *child, GtkTextWindowType which_window, gint xpos, gint ypos) { GtkTextViewChild *vc; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_WIDGET (child)); g_return_if_fail (child->parent == NULL); vc = text_view_child_new_window (child, which_window, xpos, ypos); add_child (text_view, vc); g_assert (vc->widget == child); g_assert (gtk_widget_get_parent (child) == GTK_WIDGET (text_view)); } /** * gtk_text_view_move_child: * @text_view: a #GtkTextView * @child: child widget already added to the text view * @xpos: new X position in window coordinates * @ypos: new Y position in window coordinates * * Updates the position of a child, as for gtk_text_view_add_child_in_window(). **/ void gtk_text_view_move_child (GtkTextView *text_view, GtkWidget *child, gint xpos, gint ypos) { GtkTextViewChild *vc; g_return_if_fail (GTK_IS_TEXT_VIEW (text_view)); g_return_if_fail (GTK_IS_WIDGET (child)); g_return_if_fail (child->parent == (GtkWidget*) text_view); vc = g_object_get_data (G_OBJECT (child), "gtk-text-view-child"); g_assert (vc != NULL); if (vc->x == xpos && vc->y == ypos) return; vc->x = xpos; vc->y = ypos; if (gtk_widget_get_visible (child) && gtk_widget_get_visible (GTK_WIDGET (text_view))) gtk_widget_queue_resize (child); } /* 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. * * Return value: %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->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. * * Return value: %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->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. * * Return value: %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->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. * * Return value: %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->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. * * Return value: %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->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. * * Return value: %TRUE if @iter moved and is not on the end iterator **/ gboolean gtk_text_view_move_visually (GtkTextView *text_view, GtkTextIter *iter, gint 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->layout, iter, count); } #define __GTK_TEXT_VIEW_C__ #include "gtkaliasdef.c"