/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* GTK - The GIMP Toolkit * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * 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 #include #include "gdk/gdkkeysyms.h" #include "gtkbindings.h" #include "gtkcelleditable.h" #include "gtkclipboard.h" #include "gtkdnd.h" #include "gtkentry.h" #include "gtkimagemenuitem.h" #include "gtkimcontextsimple.h" #include "gtkimmulticontext.h" #include "gtkintl.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkmenu.h" #include "gtkmenuitem.h" #include "gtkseparatormenuitem.h" #include "gtkselection.h" #include "gtksettings.h" #include "gtkspinbutton.h" #include "gtkstock.h" #include "gtktextutil.h" #include "gtkwindow.h" #include "gtktreeview.h" #include "gtktreeselection.h" #include "gtkprivate.h" #include "gtkentryprivate.h" #include "gtkcelllayout.h" #include "gtkalias.h" #define GTK_ENTRY_COMPLETION_KEY "gtk-entry-completion-key" #define MIN_ENTRY_WIDTH 150 #define DRAW_TIMEOUT 20 #define COMPLETION_TIMEOUT 300 #define PASSWORD_HINT_MAX 8 /* Initial size of buffer, in bytes */ #define MIN_SIZE 16 /* Maximum size of text buffer, in bytes */ #define MAX_SIZE G_MAXUSHORT static const GtkBorder default_inner_border = { 2, 2, 2, 2 }; static GQuark quark_inner_border = 0; static GQuark quark_password_hint = 0; static GQuark quark_cursor_hadjustment = 0; typedef struct _GtkEntryPrivate GtkEntryPrivate; #define GTK_ENTRY_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_ENTRY, GtkEntryPrivate)) struct _GtkEntryPrivate { gfloat xalign; gint insert_pos; guint blink_time; /* time in msec the cursor has blinked since last user event */ guint interior_focus : 1; guint real_changed : 1; guint change_count : 8; gint focus_width; GtkShadowType shadow_type; }; typedef struct _GtkEntryPasswordHint GtkEntryPasswordHint; struct _GtkEntryPasswordHint { gchar password_hint[PASSWORD_HINT_MAX]; guint password_hint_timeout_id; gint password_hint_length; gint password_hint_position; }; enum { ACTIVATE, POPULATE_POPUP, MOVE_CURSOR, INSERT_AT_CURSOR, DELETE_FROM_CURSOR, BACKSPACE, CUT_CLIPBOARD, COPY_CLIPBOARD, PASTE_CLIPBOARD, TOGGLE_OVERWRITE, LAST_SIGNAL }; enum { PROP_0, PROP_CURSOR_POSITION, PROP_SELECTION_BOUND, PROP_EDITABLE, PROP_MAX_LENGTH, PROP_VISIBILITY, PROP_HAS_FRAME, PROP_INNER_BORDER, PROP_INVISIBLE_CHAR, PROP_ACTIVATES_DEFAULT, PROP_WIDTH_CHARS, PROP_SCROLL_OFFSET, PROP_TEXT, PROP_XALIGN, PROP_TRUNCATE_MULTILINE, PROP_SHADOW_TYPE, PROP_OVERWRITE_MODE, PROP_TEXT_LENGTH }; static guint signals[LAST_SIGNAL] = { 0 }; typedef enum { CURSOR_STANDARD, CURSOR_DND } CursorType; /* GObject, GtkObject methods */ static void gtk_entry_editable_init (GtkEditableClass *iface); static void gtk_entry_cell_editable_init (GtkCellEditableIface *iface); static void gtk_entry_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_entry_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); static void gtk_entry_finalize (GObject *object); static void gtk_entry_destroy (GtkObject *object); /* GtkWidget methods */ static void gtk_entry_realize (GtkWidget *widget); static void gtk_entry_unrealize (GtkWidget *widget); static void gtk_entry_size_request (GtkWidget *widget, GtkRequisition *requisition); static void gtk_entry_size_allocate (GtkWidget *widget, GtkAllocation *allocation); static void gtk_entry_draw_frame (GtkWidget *widget, GdkRectangle *area); static gint gtk_entry_expose (GtkWidget *widget, GdkEventExpose *event); static gint gtk_entry_button_press (GtkWidget *widget, GdkEventButton *event); static gint gtk_entry_button_release (GtkWidget *widget, GdkEventButton *event); static gint gtk_entry_motion_notify (GtkWidget *widget, GdkEventMotion *event); static gint gtk_entry_key_press (GtkWidget *widget, GdkEventKey *event); static gint gtk_entry_key_release (GtkWidget *widget, GdkEventKey *event); static gint gtk_entry_focus_in (GtkWidget *widget, GdkEventFocus *event); static gint gtk_entry_focus_out (GtkWidget *widget, GdkEventFocus *event); static void gtk_entry_grab_focus (GtkWidget *widget); static void gtk_entry_style_set (GtkWidget *widget, GtkStyle *previous_style); static void gtk_entry_direction_changed (GtkWidget *widget, GtkTextDirection previous_dir); static void gtk_entry_state_changed (GtkWidget *widget, GtkStateType previous_state); static void gtk_entry_screen_changed (GtkWidget *widget, GdkScreen *old_screen); static gboolean gtk_entry_drag_drop (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time); static gboolean gtk_entry_drag_motion (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time); static void gtk_entry_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time); static void gtk_entry_drag_data_received (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time); static void gtk_entry_drag_data_get (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time); static void gtk_entry_drag_data_delete (GtkWidget *widget, GdkDragContext *context); /* GtkEditable method implementations */ static void gtk_entry_insert_text (GtkEditable *editable, const gchar *new_text, gint new_text_length, gint *position); static void gtk_entry_delete_text (GtkEditable *editable, gint start_pos, gint end_pos); static gchar * gtk_entry_get_chars (GtkEditable *editable, gint start_pos, gint end_pos); static void gtk_entry_real_set_position (GtkEditable *editable, gint position); static gint gtk_entry_get_position (GtkEditable *editable); static void gtk_entry_set_selection_bounds (GtkEditable *editable, gint start, gint end); static gboolean gtk_entry_get_selection_bounds (GtkEditable *editable, gint *start, gint *end); /* GtkCellEditable method implementations */ static void gtk_entry_start_editing (GtkCellEditable *cell_editable, GdkEvent *event); /* Default signal handlers */ static void gtk_entry_real_insert_text (GtkEditable *editable, const gchar *new_text, gint new_text_length, gint *position); static void gtk_entry_real_delete_text (GtkEditable *editable, gint start_pos, gint end_pos); static void gtk_entry_move_cursor (GtkEntry *entry, GtkMovementStep step, gint count, gboolean extend_selection); static void gtk_entry_insert_at_cursor (GtkEntry *entry, const gchar *str); static void gtk_entry_delete_from_cursor (GtkEntry *entry, GtkDeleteType type, gint count); static void gtk_entry_backspace (GtkEntry *entry); static void gtk_entry_cut_clipboard (GtkEntry *entry); static void gtk_entry_copy_clipboard (GtkEntry *entry); static void gtk_entry_paste_clipboard (GtkEntry *entry); static void gtk_entry_toggle_overwrite (GtkEntry *entry); static void gtk_entry_select_all (GtkEntry *entry); static void gtk_entry_real_activate (GtkEntry *entry); static gboolean gtk_entry_popup_menu (GtkWidget *widget); static void gtk_entry_keymap_direction_changed (GdkKeymap *keymap, GtkEntry *entry); /* IM Context Callbacks */ static void gtk_entry_commit_cb (GtkIMContext *context, const gchar *str, GtkEntry *entry); static void gtk_entry_preedit_changed_cb (GtkIMContext *context, GtkEntry *entry); static gboolean gtk_entry_retrieve_surrounding_cb (GtkIMContext *context, GtkEntry *entry); static gboolean gtk_entry_delete_surrounding_cb (GtkIMContext *context, gint offset, gint n_chars, GtkEntry *entry); /* Internal routines */ static void gtk_entry_enter_text (GtkEntry *entry, const gchar *str); static void gtk_entry_set_positions (GtkEntry *entry, gint current_pos, gint selection_bound); static void gtk_entry_draw_text (GtkEntry *entry); static void gtk_entry_draw_cursor (GtkEntry *entry, CursorType type); static PangoLayout *gtk_entry_ensure_layout (GtkEntry *entry, gboolean include_preedit); static void gtk_entry_reset_layout (GtkEntry *entry); static void gtk_entry_queue_draw (GtkEntry *entry); static void gtk_entry_recompute (GtkEntry *entry); static gint gtk_entry_find_position (GtkEntry *entry, gint x); static void gtk_entry_get_cursor_locations (GtkEntry *entry, CursorType type, gint *strong_x, gint *weak_x); static void gtk_entry_adjust_scroll (GtkEntry *entry); static gint gtk_entry_move_visually (GtkEntry *editable, gint start, gint count); static gint gtk_entry_move_logically (GtkEntry *entry, gint start, gint count); static gint gtk_entry_move_forward_word (GtkEntry *entry, gint start, gboolean allow_whitespace); static gint gtk_entry_move_backward_word (GtkEntry *entry, gint start, gboolean allow_whitespace); static void gtk_entry_delete_whitespace (GtkEntry *entry); static void gtk_entry_select_word (GtkEntry *entry); static void gtk_entry_select_line (GtkEntry *entry); static char * gtk_entry_get_public_chars (GtkEntry *entry, gint start, gint end); static void gtk_entry_paste (GtkEntry *entry, GdkAtom selection); static void gtk_entry_update_primary_selection (GtkEntry *entry); static void gtk_entry_do_popup (GtkEntry *entry, GdkEventButton *event); static gboolean gtk_entry_mnemonic_activate (GtkWidget *widget, gboolean group_cycling); static void gtk_entry_state_changed (GtkWidget *widget, GtkStateType previous_state); static void gtk_entry_check_cursor_blink (GtkEntry *entry); static void gtk_entry_pend_cursor_blink (GtkEntry *entry); static void gtk_entry_reset_blink_time (GtkEntry *entry); static void get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height); static void gtk_entry_get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height); static void get_widget_window_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height); static void gtk_entry_move_adjustments (GtkEntry *entry); /* Completion */ static gint gtk_entry_completion_timeout (gpointer data); static gboolean gtk_entry_completion_key_press (GtkWidget *widget, GdkEventKey *event, gpointer user_data); static void gtk_entry_completion_changed (GtkWidget *entry, gpointer user_data); static gboolean check_completion_callback (GtkEntryCompletion *completion); static void clear_completion_callback (GtkEntry *entry, GParamSpec *pspec); static gboolean accept_completion_callback (GtkEntry *entry); static void completion_insert_text_callback (GtkEntry *entry, const gchar *text, gint length, gint position, GtkEntryCompletion *completion); static void completion_changed (GtkEntryCompletion *completion, GParamSpec *pspec, gpointer data); static void disconnect_completion_signals (GtkEntry *entry, GtkEntryCompletion *completion); static void connect_completion_signals (GtkEntry *entry, GtkEntryCompletion *completion); static void begin_change (GtkEntry *entry); static void end_change (GtkEntry *entry); static void emit_changed (GtkEntry *entry); G_DEFINE_TYPE_WITH_CODE (GtkEntry, gtk_entry, GTK_TYPE_WIDGET, G_IMPLEMENT_INTERFACE (GTK_TYPE_EDITABLE, gtk_entry_editable_init) G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_EDITABLE, gtk_entry_cell_editable_init)) static void add_move_binding (GtkBindingSet *binding_set, guint keyval, guint modmask, GtkMovementStep step, gint count) { g_return_if_fail ((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_entry_class_init (GtkEntryClass *class) { GObjectClass *gobject_class = G_OBJECT_CLASS (class); GtkWidgetClass *widget_class; GtkObjectClass *gtk_object_class; GtkBindingSet *binding_set; widget_class = (GtkWidgetClass*) class; gtk_object_class = (GtkObjectClass *)class; gobject_class->finalize = gtk_entry_finalize; gobject_class->set_property = gtk_entry_set_property; gobject_class->get_property = gtk_entry_get_property; widget_class->realize = gtk_entry_realize; widget_class->unrealize = gtk_entry_unrealize; widget_class->size_request = gtk_entry_size_request; widget_class->size_allocate = gtk_entry_size_allocate; widget_class->expose_event = gtk_entry_expose; widget_class->button_press_event = gtk_entry_button_press; widget_class->button_release_event = gtk_entry_button_release; widget_class->motion_notify_event = gtk_entry_motion_notify; widget_class->key_press_event = gtk_entry_key_press; widget_class->key_release_event = gtk_entry_key_release; widget_class->focus_in_event = gtk_entry_focus_in; widget_class->focus_out_event = gtk_entry_focus_out; widget_class->grab_focus = gtk_entry_grab_focus; widget_class->style_set = gtk_entry_style_set; widget_class->direction_changed = gtk_entry_direction_changed; widget_class->state_changed = gtk_entry_state_changed; widget_class->screen_changed = gtk_entry_screen_changed; widget_class->mnemonic_activate = gtk_entry_mnemonic_activate; widget_class->drag_drop = gtk_entry_drag_drop; widget_class->drag_motion = gtk_entry_drag_motion; widget_class->drag_leave = gtk_entry_drag_leave; widget_class->drag_data_received = gtk_entry_drag_data_received; widget_class->drag_data_get = gtk_entry_drag_data_get; widget_class->drag_data_delete = gtk_entry_drag_data_delete; widget_class->popup_menu = gtk_entry_popup_menu; gtk_object_class->destroy = gtk_entry_destroy; class->move_cursor = gtk_entry_move_cursor; class->insert_at_cursor = gtk_entry_insert_at_cursor; class->delete_from_cursor = gtk_entry_delete_from_cursor; class->backspace = gtk_entry_backspace; class->cut_clipboard = gtk_entry_cut_clipboard; class->copy_clipboard = gtk_entry_copy_clipboard; class->paste_clipboard = gtk_entry_paste_clipboard; class->toggle_overwrite = gtk_entry_toggle_overwrite; class->activate = gtk_entry_real_activate; class->get_text_area_size = gtk_entry_get_text_area_size; quark_inner_border = g_quark_from_static_string ("gtk-entry-inner-border"); quark_password_hint = g_quark_from_static_string ("gtk-entry-password-hint"); quark_cursor_hadjustment = g_quark_from_static_string ("gtk-hadjustment"); g_object_class_install_property (gobject_class, PROP_CURSOR_POSITION, g_param_spec_int ("cursor-position", P_("Cursor Position"), P_("The current position of the insertion cursor in chars"), 0, MAX_SIZE, 0, GTK_PARAM_READABLE)); g_object_class_install_property (gobject_class, PROP_SELECTION_BOUND, g_param_spec_int ("selection-bound", P_("Selection Bound"), P_("The position of the opposite end of the selection from the cursor in chars"), 0, MAX_SIZE, 0, GTK_PARAM_READABLE)); g_object_class_install_property (gobject_class, PROP_EDITABLE, g_param_spec_boolean ("editable", P_("Editable"), P_("Whether the entry contents can be edited"), TRUE, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_MAX_LENGTH, g_param_spec_int ("max-length", P_("Maximum length"), P_("Maximum number of characters for this entry. Zero if no maximum"), 0, MAX_SIZE, 0, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_VISIBILITY, g_param_spec_boolean ("visibility", P_("Visibility"), P_("FALSE displays the \"invisible char\" instead of the actual text (password mode)"), TRUE, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_HAS_FRAME, g_param_spec_boolean ("has-frame", P_("Has Frame"), P_("FALSE removes outside bevel from entry"), TRUE, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_INNER_BORDER, g_param_spec_boxed ("inner-border", P_("Inner Border"), P_("Border between text and frame. Overrides the inner-border style property"), GTK_TYPE_BORDER, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_INVISIBLE_CHAR, g_param_spec_unichar ("invisible-char", P_("Invisible character"), P_("The character to use when masking entry contents (in \"password mode\")"), '*', GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_ACTIVATES_DEFAULT, g_param_spec_boolean ("activates-default", P_("Activates default"), P_("Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed"), FALSE, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_WIDTH_CHARS, g_param_spec_int ("width-chars", P_("Width in chars"), P_("Number of characters to leave space for in the entry"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_SCROLL_OFFSET, g_param_spec_int ("scroll-offset", P_("Scroll offset"), P_("Number of pixels of the entry scrolled off the screen to the left"), 0, G_MAXINT, 0, GTK_PARAM_READABLE)); g_object_class_install_property (gobject_class, PROP_TEXT, g_param_spec_string ("text", P_("Text"), P_("The contents of the entry"), "", GTK_PARAM_READWRITE)); /** * GtkEntry:xalign: * * The horizontal alignment, from 0 (left) to 1 (right). * Reversed for RTL layouts. * * Since: 2.4 */ g_object_class_install_property (gobject_class, PROP_XALIGN, g_param_spec_float ("xalign", P_("X align"), P_("The horizontal alignment, from 0 (left) to 1 (right). Reversed for RTL layouts."), 0.0, 1.0, 0.0, GTK_PARAM_READWRITE)); /** * GtkEntry:truncate-multiline: * * When %TRUE, pasted multi-line text is truncated to the first line. * * Since: 2.10 */ g_object_class_install_property (gobject_class, PROP_TRUNCATE_MULTILINE, g_param_spec_boolean ("truncate-multiline", P_("Truncate multiline"), P_("Whether to truncate multiline pastes to one line."), FALSE, GTK_PARAM_READWRITE)); /** * GtkEntry:shadow-type: * * Which kind of shadow to draw around the entry when * #GtkEntry:has-frame is set to %TRUE. * * Since: 2.12 */ g_object_class_install_property (gobject_class, PROP_SHADOW_TYPE, g_param_spec_enum ("shadow-type", P_("Shadow type"), P_("Which kind of shadow to draw around the entry when has-frame is set"), GTK_TYPE_SHADOW_TYPE, GTK_SHADOW_IN, GTK_PARAM_READWRITE)); /** * GtkEntry:overwrite-mode: * * If text is overwritten when typing in the #GtkEntry. * * Since: 2.14 */ g_object_class_install_property (gobject_class, PROP_OVERWRITE_MODE, g_param_spec_boolean ("overwrite-mode", P_("Overwrite mode"), P_("Whether new text overwrites existing text"), FALSE, GTK_PARAM_READWRITE)); /** * GtkEntry:text-length: * * The length of the text in the #GtkEntry. * * Since: 2.14 */ g_object_class_install_property (gobject_class, PROP_TEXT_LENGTH, g_param_spec_uint ("text-length", P_("Text length"), P_("Length of the text currently in the entry"), 0, G_MAXUINT16, 0, GTK_PARAM_READABLE)); signals[POPULATE_POPUP] = g_signal_new (I_("populate_popup"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkEntryClass, populate_popup), NULL, NULL, _gtk_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GTK_TYPE_MENU); /* Action signals */ signals[ACTIVATE] = g_signal_new (I_("activate"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, activate), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); widget_class->activate_signal = signals[ACTIVATE]; 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 (GtkEntryClass, move_cursor), NULL, NULL, _gtk_marshal_VOID__ENUM_INT_BOOLEAN, G_TYPE_NONE, 3, GTK_TYPE_MOVEMENT_STEP, G_TYPE_INT, G_TYPE_BOOLEAN); 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 (GtkEntryClass, insert_at_cursor), NULL, NULL, _gtk_marshal_VOID__STRING, G_TYPE_NONE, 1, G_TYPE_STRING); 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 (GtkEntryClass, delete_from_cursor), NULL, NULL, _gtk_marshal_VOID__ENUM_INT, G_TYPE_NONE, 2, GTK_TYPE_DELETE_TYPE, G_TYPE_INT); signals[BACKSPACE] = g_signal_new (I_("backspace"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, backspace), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); 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 (GtkEntryClass, cut_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); 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 (GtkEntryClass, copy_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); 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 (GtkEntryClass, paste_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); 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 (GtkEntryClass, toggle_overwrite), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /* * Key bindings */ binding_set = gtk_binding_set_by_class (class); /* Moving the insertion point */ add_move_binding (binding_set, GDK_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_Right, 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_Left, 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_KP_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (binding_set, GDK_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_Home, 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_End, 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_KP_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); /* Select all */ gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_BUFFER_ENDS, G_TYPE_INT, -1, G_TYPE_BOOLEAN, FALSE); gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_BUFFER_ENDS, G_TYPE_INT, 1, G_TYPE_BOOLEAN, TRUE); gtk_binding_entry_add_signal (binding_set, GDK_slash, GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_BUFFER_ENDS, G_TYPE_INT, -1, G_TYPE_BOOLEAN, FALSE); gtk_binding_entry_add_signal (binding_set, GDK_slash, GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_BUFFER_ENDS, G_TYPE_INT, 1, G_TYPE_BOOLEAN, TRUE); /* Unselect all */ gtk_binding_entry_add_signal (binding_set, GDK_backslash, GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_VISUAL_POSITIONS, G_TYPE_INT, 0, G_TYPE_BOOLEAN, FALSE); gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_SHIFT_MASK | GDK_CONTROL_MASK, "move_cursor", 3, GTK_TYPE_MOVEMENT_STEP, GTK_MOVEMENT_VISUAL_POSITIONS, G_TYPE_INT, 0, G_TYPE_BOOLEAN, FALSE); /* Activate */ gtk_binding_entry_add_signal (binding_set, GDK_Return, 0, "activate", 0); gtk_binding_entry_add_signal (binding_set, GDK_ISO_Enter, 0, "activate", 0); gtk_binding_entry_add_signal (binding_set, GDK_KP_Enter, 0, "activate", 0); /* 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); /* 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); /** * GtkEntry:inner-border: * * Sets the text area's border between the text and the frame. * * Since: 2.10 */ gtk_widget_class_install_style_property (widget_class, g_param_spec_boxed ("inner-border", P_("Inner Border"), P_("Border between text and frame."), GTK_TYPE_BORDER, GTK_PARAM_READABLE)); gtk_settings_install_property (g_param_spec_boolean ("gtk-entry-select-on-focus", P_("Select on focus"), P_("Whether to select the contents of an entry when it is focused"), TRUE, GTK_PARAM_READWRITE)); /** * GtkSettings:gtk-entry-password-hint-timeout: * * How long to show the last input character in hidden * entries. This value is in milliseconds. 0 disables showing the * last char. 600 is a good value for enabling it. * * Since: 2.10 */ gtk_settings_install_property (g_param_spec_uint ("gtk-entry-password-hint-timeout", P_("Password Hint Timeout"), P_("How long to show the last input character in hidden entries"), 0, G_MAXUINT, 0, GTK_PARAM_READWRITE)); g_type_class_add_private (gobject_class, sizeof (GtkEntryPrivate)); } static void gtk_entry_editable_init (GtkEditableClass *iface) { iface->do_insert_text = gtk_entry_insert_text; iface->do_delete_text = gtk_entry_delete_text; iface->insert_text = gtk_entry_real_insert_text; iface->delete_text = gtk_entry_real_delete_text; iface->get_chars = gtk_entry_get_chars; iface->set_selection_bounds = gtk_entry_set_selection_bounds; iface->get_selection_bounds = gtk_entry_get_selection_bounds; iface->set_position = gtk_entry_real_set_position; iface->get_position = gtk_entry_get_position; } static void gtk_entry_cell_editable_init (GtkCellEditableIface *iface) { iface->start_editing = gtk_entry_start_editing; } static void gtk_entry_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (object); GtkEntry *entry = GTK_ENTRY (object); switch (prop_id) { case PROP_EDITABLE: { gboolean new_value = g_value_get_boolean (value); if (new_value != entry->editable) { if (!new_value) { _gtk_entry_reset_im_context (entry); if (GTK_WIDGET_HAS_FOCUS (entry)) gtk_im_context_focus_out (entry->im_context); entry->preedit_length = 0; entry->preedit_cursor = 0; } entry->editable = new_value; if (new_value && GTK_WIDGET_HAS_FOCUS (entry)) gtk_im_context_focus_in (entry->im_context); gtk_entry_queue_draw (entry); } } break; case PROP_MAX_LENGTH: gtk_entry_set_max_length (entry, g_value_get_int (value)); break; case PROP_VISIBILITY: gtk_entry_set_visibility (entry, g_value_get_boolean (value)); break; case PROP_HAS_FRAME: gtk_entry_set_has_frame (entry, g_value_get_boolean (value)); break; case PROP_INNER_BORDER: gtk_entry_set_inner_border (entry, g_value_get_boxed (value)); break; case PROP_INVISIBLE_CHAR: gtk_entry_set_invisible_char (entry, g_value_get_uint (value)); break; case PROP_ACTIVATES_DEFAULT: gtk_entry_set_activates_default (entry, g_value_get_boolean (value)); break; case PROP_WIDTH_CHARS: gtk_entry_set_width_chars (entry, g_value_get_int (value)); break; case PROP_TEXT: gtk_entry_set_text (entry, g_value_get_string (value)); break; case PROP_XALIGN: gtk_entry_set_alignment (entry, g_value_get_float (value)); break; case PROP_TRUNCATE_MULTILINE: entry->truncate_multiline = g_value_get_boolean (value); break; case PROP_SHADOW_TYPE: priv->shadow_type = g_value_get_enum (value); break; case PROP_OVERWRITE_MODE: gtk_entry_set_overwrite_mode (entry, g_value_get_boolean (value)); break; case PROP_SCROLL_OFFSET: case PROP_CURSOR_POSITION: default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_entry_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (object); GtkEntry *entry = GTK_ENTRY (object); switch (prop_id) { case PROP_CURSOR_POSITION: g_value_set_int (value, entry->current_pos); break; case PROP_SELECTION_BOUND: g_value_set_int (value, entry->selection_bound); break; case PROP_EDITABLE: g_value_set_boolean (value, entry->editable); break; case PROP_MAX_LENGTH: g_value_set_int (value, entry->text_max_length); break; case PROP_VISIBILITY: g_value_set_boolean (value, entry->visible); break; case PROP_HAS_FRAME: g_value_set_boolean (value, entry->has_frame); break; case PROP_INNER_BORDER: g_value_set_boxed (value, gtk_entry_get_inner_border (entry)); break; case PROP_INVISIBLE_CHAR: g_value_set_uint (value, entry->invisible_char); break; case PROP_ACTIVATES_DEFAULT: g_value_set_boolean (value, entry->activates_default); break; case PROP_WIDTH_CHARS: g_value_set_int (value, entry->width_chars); break; case PROP_SCROLL_OFFSET: g_value_set_int (value, entry->scroll_offset); break; case PROP_TEXT: g_value_set_string (value, gtk_entry_get_text (entry)); break; case PROP_XALIGN: g_value_set_float (value, gtk_entry_get_alignment (entry)); break; case PROP_TRUNCATE_MULTILINE: g_value_set_boolean (value, entry->truncate_multiline); break; case PROP_SHADOW_TYPE: g_value_set_enum (value, priv->shadow_type); break; case PROP_OVERWRITE_MODE: g_value_set_boolean (value, entry->overwrite_mode); break; case PROP_TEXT_LENGTH: g_value_set_uint (value, entry->text_length); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_entry_init (GtkEntry *entry) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); GTK_WIDGET_SET_FLAGS (entry, GTK_CAN_FOCUS); entry->text_size = MIN_SIZE; entry->text = g_malloc (entry->text_size); entry->text[0] = '\0'; entry->editable = TRUE; entry->visible = TRUE; entry->invisible_char = '*'; entry->dnd_position = -1; entry->width_chars = -1; entry->is_cell_renderer = FALSE; entry->editing_canceled = FALSE; entry->has_frame = TRUE; entry->truncate_multiline = FALSE; priv->shadow_type = GTK_SHADOW_IN; priv->xalign = 0.0; gtk_drag_dest_set (GTK_WIDGET (entry), GTK_DEST_DEFAULT_HIGHLIGHT, NULL, 0, GDK_ACTION_COPY | GDK_ACTION_MOVE); gtk_drag_dest_add_text_targets (GTK_WIDGET (entry)); /* This object is completely private. No external entity can gain a reference * to it; so we create it here and destroy it in finalize(). */ entry->im_context = gtk_im_multicontext_new (); g_signal_connect (entry->im_context, "commit", G_CALLBACK (gtk_entry_commit_cb), entry); g_signal_connect (entry->im_context, "preedit_changed", G_CALLBACK (gtk_entry_preedit_changed_cb), entry); g_signal_connect (entry->im_context, "retrieve_surrounding", G_CALLBACK (gtk_entry_retrieve_surrounding_cb), entry); g_signal_connect (entry->im_context, "delete_surrounding", G_CALLBACK (gtk_entry_delete_surrounding_cb), entry); } static void begin_change (GtkEntry *entry) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); priv->change_count++; } static void end_change (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); g_return_if_fail (priv->change_count > 0); priv->change_count--; if (priv->change_count == 0) { if (priv->real_changed) { g_signal_emit_by_name (editable, "changed"); priv->real_changed = FALSE; } } } static void emit_changed (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); if (priv->change_count == 0) g_signal_emit_by_name (editable, "changed"); else priv->real_changed = TRUE; } /* * Overwrite a memory that might contain sensitive information. */ static void trash_area (gchar *area, gsize len) { volatile gchar *varea = (volatile gchar *)area; while (len-- > 0) *varea++ = 0; } static void gtk_entry_destroy (GtkObject *object) { GtkEntry *entry = GTK_ENTRY (object); entry->n_bytes = 0; entry->current_pos = entry->selection_bound = entry->text_length = 0; _gtk_entry_reset_im_context (entry); gtk_entry_reset_layout (entry); if (entry->blink_timeout) { g_source_remove (entry->blink_timeout); entry->blink_timeout = 0; } if (entry->recompute_idle) { g_source_remove (entry->recompute_idle); entry->recompute_idle = 0; } if (!entry->visible) { /* We want to trash the text here because the entry might be leaked. */ trash_area (entry->text, strlen (entry->text)); } GTK_OBJECT_CLASS (gtk_entry_parent_class)->destroy (object); } static void gtk_entry_finalize (GObject *object) { GtkEntry *entry = GTK_ENTRY (object); gtk_entry_set_completion (entry, NULL); if (entry->cached_layout) g_object_unref (entry->cached_layout); g_object_unref (entry->im_context); if (entry->blink_timeout) g_source_remove (entry->blink_timeout); if (entry->recompute_idle) g_source_remove (entry->recompute_idle); entry->text_size = 0; if (entry->text) { if (!entry->visible) trash_area (entry->text, strlen (entry->text)); g_free (entry->text); entry->text = NULL; } G_OBJECT_CLASS (gtk_entry_parent_class)->finalize (object); } static void gtk_entry_realize (GtkWidget *widget) { GtkEntry *entry; GdkWindowAttr attributes; gint attributes_mask; GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED); entry = GTK_ENTRY (widget); attributes.window_type = GDK_WINDOW_CHILD; get_widget_window_size (entry, &attributes.x, &attributes.y, &attributes.width, &attributes.height); attributes.wclass = GDK_INPUT_OUTPUT; attributes.visual = gtk_widget_get_visual (widget); attributes.colormap = gtk_widget_get_colormap (widget); attributes.event_mask = gtk_widget_get_events (widget); attributes.event_mask |= (GDK_EXPOSURE_MASK | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK | GDK_BUTTON1_MOTION_MASK | GDK_BUTTON3_MOTION_MASK | GDK_POINTER_MOTION_HINT_MASK | GDK_POINTER_MOTION_MASK | GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_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, entry); get_text_area_size (entry, &attributes.x, &attributes.y, &attributes.width, &attributes.height); if (GTK_WIDGET_IS_SENSITIVE (widget)) { attributes.cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget), GDK_XTERM); attributes_mask |= GDK_WA_CURSOR; } entry->text_area = gdk_window_new (widget->window, &attributes, attributes_mask); gdk_window_set_user_data (entry->text_area, entry); if (attributes_mask & GDK_WA_CURSOR) gdk_cursor_unref (attributes.cursor); widget->style = gtk_style_attach (widget->style, widget->window); gdk_window_set_background (widget->window, &widget->style->base[GTK_WIDGET_STATE (widget)]); gdk_window_set_background (entry->text_area, &widget->style->base[GTK_WIDGET_STATE (widget)]); gdk_window_show (entry->text_area); gtk_im_context_set_client_window (entry->im_context, entry->text_area); gtk_entry_adjust_scroll (entry); gtk_entry_update_primary_selection (entry); } static void gtk_entry_unrealize (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkClipboard *clipboard; gtk_entry_reset_layout (entry); gtk_im_context_set_client_window (entry->im_context, NULL); clipboard = gtk_widget_get_clipboard (widget, GDK_SELECTION_PRIMARY); if (gtk_clipboard_get_owner (clipboard) == G_OBJECT (entry)) gtk_clipboard_clear (clipboard); if (entry->text_area) { gdk_window_set_user_data (entry->text_area, NULL); gdk_window_destroy (entry->text_area); entry->text_area = NULL; } if (entry->popup_menu) { gtk_widget_destroy (entry->popup_menu); entry->popup_menu = NULL; } if (GTK_WIDGET_CLASS (gtk_entry_parent_class)->unrealize) (* GTK_WIDGET_CLASS (gtk_entry_parent_class)->unrealize) (widget); } void _gtk_entry_get_borders (GtkEntry *entry, gint *xborder, gint *yborder) { GtkWidget *widget = GTK_WIDGET (entry); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (widget); if (entry->has_frame) { *xborder = widget->style->xthickness; *yborder = widget->style->ythickness; } else { *xborder = 0; *yborder = 0; } if (!priv->interior_focus) { *xborder += priv->focus_width; *yborder += priv->focus_width; } } static void gtk_entry_size_request (GtkWidget *widget, GtkRequisition *requisition) { GtkEntry *entry = GTK_ENTRY (widget); PangoFontMetrics *metrics; gint xborder, yborder; GtkBorder inner_border; PangoContext *context; gtk_widget_ensure_style (widget); context = gtk_widget_get_pango_context (widget); metrics = pango_context_get_metrics (context, widget->style->font_desc, pango_context_get_language (context)); entry->ascent = pango_font_metrics_get_ascent (metrics); entry->descent = pango_font_metrics_get_descent (metrics); _gtk_entry_get_borders (entry, &xborder, &yborder); _gtk_entry_effective_inner_border (entry, &inner_border); if (entry->width_chars < 0) requisition->width = MIN_ENTRY_WIDTH + xborder * 2 + inner_border.left + inner_border.right; else { gint char_width = pango_font_metrics_get_approximate_char_width (metrics); gint digit_width = pango_font_metrics_get_approximate_digit_width (metrics); gint char_pixels = (MAX (char_width, digit_width) + PANGO_SCALE - 1) / PANGO_SCALE; requisition->width = char_pixels * entry->width_chars + xborder * 2 + inner_border.left + inner_border.right; } requisition->height = PANGO_PIXELS (entry->ascent + entry->descent) + yborder * 2 + inner_border.top + inner_border.bottom; pango_font_metrics_unref (metrics); } static void get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height) { GtkEntryClass *class; g_return_if_fail (GTK_IS_ENTRY (entry)); class = GTK_ENTRY_GET_CLASS (entry); if (class->get_text_area_size) class->get_text_area_size (entry, x, y, width, height); } static void gtk_entry_get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height) { gint frame_height; gint xborder, yborder; GtkRequisition requisition; GtkWidget *widget = GTK_WIDGET (entry); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (widget); gtk_widget_get_child_requisition (widget, &requisition); _gtk_entry_get_borders (entry, &xborder, &yborder); if (GTK_WIDGET_REALIZED (widget)) gdk_drawable_get_size (widget->window, NULL, &frame_height); else frame_height = requisition.height; if (GTK_WIDGET_HAS_FOCUS (widget) && !priv->interior_focus) frame_height -= 2 * priv->focus_width; if (x) *x = xborder; if (y) *y = frame_height / 2 - (requisition.height - yborder * 2) / 2; if (width) *width = GTK_WIDGET (entry)->allocation.width - xborder * 2; if (height) *height = requisition.height - yborder * 2; } static void get_widget_window_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height) { GtkRequisition requisition; GtkWidget *widget = GTK_WIDGET (entry); gtk_widget_get_child_requisition (widget, &requisition); if (x) *x = widget->allocation.x; if (y) { if (entry->is_cell_renderer) *y = widget->allocation.y; else *y = widget->allocation.y + (widget->allocation.height - requisition.height) / 2; } if (width) *width = widget->allocation.width; if (height) { if (entry->is_cell_renderer) *height = widget->allocation.height; else *height = requisition.height; } } void _gtk_entry_effective_inner_border (GtkEntry *entry, GtkBorder *border) { GtkBorder *tmp_border; tmp_border = g_object_get_qdata (G_OBJECT (entry), quark_inner_border); if (tmp_border) { *border = *tmp_border; return; } gtk_widget_style_get (GTK_WIDGET (entry), "inner-border", &tmp_border, NULL); if (tmp_border) { *border = *tmp_border; gtk_border_free (tmp_border); return; } *border = default_inner_border; } static void gtk_entry_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkEntry *entry = GTK_ENTRY (widget); widget->allocation = *allocation; if (GTK_WIDGET_REALIZED (widget)) { /* We call gtk_widget_get_child_requisition, since we want (for * backwards compatibility reasons) the realization here to * be affected by the usize of the entry, if set */ gint x, y, width, height; get_widget_window_size (entry, &x, &y, &width, &height); gdk_window_move_resize (widget->window, x, y, width, height); get_text_area_size (entry, &x, &y, &width, &height); gdk_window_move_resize (entry->text_area, x, y, width, height); gtk_entry_recompute (entry); } } static void gtk_entry_draw_frame (GtkWidget *widget, GdkRectangle *area) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (widget); gint x = 0, y = 0, width, height; gdk_drawable_get_size (widget->window, &width, &height); /* Fix a problem with some themes which assume that entry->text_area's * width equals widget->window's width */ if (GTK_IS_SPIN_BUTTON (widget)) { gint xborder, yborder; get_text_area_size (GTK_ENTRY (widget), &x, NULL, &width, NULL); _gtk_entry_get_borders (GTK_ENTRY (widget), &xborder, &yborder); x -= xborder; width += xborder * 2; } if (GTK_WIDGET_HAS_FOCUS (widget) && !priv->interior_focus) { x += priv->focus_width; y += priv->focus_width; width -= 2 * priv->focus_width; height -= 2 * priv->focus_width; } gtk_paint_shadow (widget->style, widget->window, GTK_STATE_NORMAL, priv->shadow_type, area, widget, "entry", x, y, width, height); if (GTK_WIDGET_HAS_FOCUS (widget) && !priv->interior_focus) { x -= priv->focus_width; y -= priv->focus_width; width += 2 * priv->focus_width; height += 2 * priv->focus_width; gtk_paint_focus (widget->style, widget->window, GTK_WIDGET_STATE (widget), area, widget, "entry", 0, 0, width, height); } } static gint gtk_entry_expose (GtkWidget *widget, GdkEventExpose *event) { GtkEntry *entry = GTK_ENTRY (widget); if (widget->window == event->window) gtk_entry_draw_frame (widget, &event->area); else if (entry->text_area == event->window) { gint area_width, area_height; gdk_drawable_get_size (entry->text_area, &area_width, &area_height); gtk_paint_flat_box (widget->style, entry->text_area, GTK_WIDGET_STATE(widget), GTK_SHADOW_NONE, &event->area, widget, "entry_bg", 0, 0, area_width, area_height); if (entry->dnd_position != -1) gtk_entry_draw_cursor (GTK_ENTRY (widget), CURSOR_DND); gtk_entry_draw_text (GTK_ENTRY (widget)); if ((entry->visible || entry->invisible_char != 0) && GTK_WIDGET_HAS_FOCUS (widget) && entry->selection_bound == entry->current_pos && entry->cursor_visible) gtk_entry_draw_cursor (GTK_ENTRY (widget), CURSOR_STANDARD); } return FALSE; } static void gtk_entry_get_pixel_ranges (GtkEntry *entry, gint **ranges, gint *n_ranges) { gint start_char, end_char; if (gtk_editable_get_selection_bounds (GTK_EDITABLE (entry), &start_char, &end_char)) { PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); PangoLayoutLine *line = pango_layout_get_lines_readonly (layout)->data; const char *text = pango_layout_get_text (layout); gint start_index = g_utf8_offset_to_pointer (text, start_char) - text; gint end_index = g_utf8_offset_to_pointer (text, end_char) - text; gint real_n_ranges, i; pango_layout_line_get_x_ranges (line, start_index, end_index, ranges, &real_n_ranges); if (ranges) { gint *r = *ranges; for (i = 0; i < real_n_ranges; ++i) { r[2 * i + 1] = (r[2 * i + 1] - r[2 * i]) / PANGO_SCALE; r[2 * i] = r[2 * i] / PANGO_SCALE; } } if (n_ranges) *n_ranges = real_n_ranges; } else { if (n_ranges) *n_ranges = 0; if (ranges) *ranges = NULL; } } static gboolean in_selection (GtkEntry *entry, gint x) { gint *ranges; gint n_ranges, i; gint retval = FALSE; gtk_entry_get_pixel_ranges (entry, &ranges, &n_ranges); for (i = 0; i < n_ranges; ++i) { if (x >= ranges[2 * i] && x < ranges[2 * i] + ranges[2 * i + 1]) { retval = TRUE; break; } } g_free (ranges); return retval; } static gint gtk_entry_button_press (GtkWidget *widget, GdkEventButton *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEditable *editable = GTK_EDITABLE (widget); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); gint tmp_pos; gint sel_start, sel_end; if (event->window != entry->text_area || (entry->button && event->button != entry->button)) return FALSE; gtk_entry_reset_blink_time (entry); entry->button = event->button; if (!GTK_WIDGET_HAS_FOCUS (widget)) { entry->in_click = TRUE; gtk_widget_grab_focus (widget); entry->in_click = FALSE; } tmp_pos = gtk_entry_find_position (entry, event->x + entry->scroll_offset); if (event->button == 1) { gboolean have_selection = gtk_editable_get_selection_bounds (editable, &sel_start, &sel_end); entry->select_words = FALSE; entry->select_lines = FALSE; if (event->state & GDK_SHIFT_MASK) { _gtk_entry_reset_im_context (entry); if (!have_selection) /* select from the current position to the clicked position */ sel_start = sel_end = entry->current_pos; if (tmp_pos > sel_start && tmp_pos < sel_end) { /* Truncate current selection, but keep it as big as possible */ if (tmp_pos - sel_start > sel_end - tmp_pos) gtk_entry_set_positions (entry, sel_start, tmp_pos); else gtk_entry_set_positions (entry, tmp_pos, sel_end); } else { gboolean extend_to_left; gint start, end; /* Figure out what click selects and extend current selection */ switch (event->type) { case GDK_BUTTON_PRESS: gtk_entry_set_positions (entry, tmp_pos, tmp_pos); break; case GDK_2BUTTON_PRESS: entry->select_words = TRUE; gtk_entry_select_word (entry); break; case GDK_3BUTTON_PRESS: entry->select_lines = TRUE; gtk_entry_select_line (entry); break; default: break; } start = MIN (entry->current_pos, entry->selection_bound); start = MIN (sel_start, start); end = MAX (entry->current_pos, entry->selection_bound); end = MAX (sel_end, end); if (tmp_pos == sel_start || tmp_pos == sel_end) extend_to_left = (tmp_pos == start); else extend_to_left = (end == sel_end); if (extend_to_left) gtk_entry_set_positions (entry, start, end); else gtk_entry_set_positions (entry, end, start); } } else /* no shift key */ switch (event->type) { case GDK_BUTTON_PRESS: if (in_selection (entry, event->x + entry->scroll_offset)) { /* Click inside the selection - we'll either start a drag, or * clear the selection */ entry->in_drag = TRUE; entry->drag_start_x = event->x + entry->scroll_offset; entry->drag_start_y = event->y; } else gtk_editable_set_position (editable, tmp_pos); break; case GDK_2BUTTON_PRESS: /* We ALWAYS receive a GDK_BUTTON_PRESS immediately before * receiving a GDK_2BUTTON_PRESS so we need to reset * entry->in_drag which may have been set above */ entry->in_drag = FALSE; entry->select_words = TRUE; gtk_entry_select_word (entry); break; case GDK_3BUTTON_PRESS: /* We ALWAYS receive a GDK_BUTTON_PRESS immediately before * receiving a GDK_3BUTTON_PRESS so we need to reset * entry->in_drag which may have been set above */ entry->in_drag = FALSE; entry->select_lines = TRUE; gtk_entry_select_line (entry); break; default: break; } return TRUE; } else if (event->button == 2 && event->type == GDK_BUTTON_PRESS) { if (entry->editable) { priv->insert_pos = tmp_pos; gtk_entry_paste (entry, GDK_SELECTION_PRIMARY); return TRUE; } else { gtk_widget_error_bell (widget); } } else if (event->button == 3 && event->type == GDK_BUTTON_PRESS) { gtk_entry_do_popup (entry, event); entry->button = 0; /* Don't wait for release, since the menu will gtk_grab_add */ return TRUE; } return FALSE; } static gint gtk_entry_button_release (GtkWidget *widget, GdkEventButton *event) { GtkEntry *entry = GTK_ENTRY (widget); if (event->window != entry->text_area || entry->button != event->button) return FALSE; if (entry->in_drag) { gint tmp_pos = gtk_entry_find_position (entry, entry->drag_start_x); gtk_editable_set_position (GTK_EDITABLE (entry), tmp_pos); entry->in_drag = 0; } entry->button = 0; gtk_entry_update_primary_selection (entry); return TRUE; } static gchar * _gtk_entry_get_selected_text (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); gint start_text, end_text; gchar *text = NULL; if (gtk_editable_get_selection_bounds (editable, &start_text, &end_text)) text = gtk_editable_get_chars (editable, start_text, end_text); return text; } static gint gtk_entry_motion_notify (GtkWidget *widget, GdkEventMotion *event) { GtkEntry *entry = GTK_ENTRY (widget); gint tmp_pos; if (entry->mouse_cursor_obscured) { GdkCursor *cursor; cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget), GDK_XTERM); gdk_window_set_cursor (entry->text_area, cursor); gdk_cursor_unref (cursor); entry->mouse_cursor_obscured = FALSE; } if (event->window != entry->text_area || entry->button != 1) return FALSE; if (entry->select_lines) return TRUE; gdk_event_request_motions (event); if (entry->in_drag) { if (gtk_drag_check_threshold (widget, entry->drag_start_x, entry->drag_start_y, event->x + entry->scroll_offset, event->y)) { GdkDragContext *context; GtkTargetList *target_list = gtk_target_list_new (NULL, 0); guint actions = entry->editable ? GDK_ACTION_COPY | GDK_ACTION_MOVE : GDK_ACTION_COPY; gchar *text = NULL; GdkPixmap *pixmap = NULL; gtk_target_list_add_text_targets (target_list, 0); if (entry->visible) { text = _gtk_entry_get_selected_text (entry); pixmap = _gtk_text_util_create_drag_icon (widget, text, -1); } context = gtk_drag_begin (widget, target_list, actions, entry->button, (GdkEvent *)event); if (pixmap) gtk_drag_set_icon_pixmap (context, gdk_drawable_get_colormap (pixmap), pixmap, NULL, -2, -2); else gtk_drag_set_icon_default (context); if (pixmap) g_object_unref (pixmap); g_free (text); entry->in_drag = FALSE; entry->button = 0; gtk_target_list_unref (target_list); } } else { gint height; gdk_drawable_get_size (entry->text_area, NULL, &height); if (event->y < 0) tmp_pos = 0; else if (event->y >= height) tmp_pos = entry->text_length; else tmp_pos = gtk_entry_find_position (entry, event->x + entry->scroll_offset); if (entry->select_words) { gint min, max; gint old_min, old_max; gint pos, bound; min = gtk_entry_move_backward_word (entry, tmp_pos, TRUE); max = gtk_entry_move_forward_word (entry, tmp_pos, TRUE); pos = entry->current_pos; bound = entry->selection_bound; old_min = MIN(entry->current_pos, entry->selection_bound); old_max = MAX(entry->current_pos, entry->selection_bound); if (min < old_min) { pos = min; bound = old_max; } else if (old_max < max) { pos = max; bound = old_min; } else if (pos == old_min) { if (entry->current_pos != min) pos = max; } else { if (entry->current_pos != max) pos = min; } gtk_entry_set_positions (entry, pos, bound); } else gtk_entry_set_positions (entry, tmp_pos, -1); } return TRUE; } static void set_invisible_cursor (GdkWindow *window) { GdkBitmap *empty_bitmap; GdkCursor *cursor; GdkColor useless; char invisible_cursor_bits[] = { 0x0 }; useless.red = useless.green = useless.blue = 0; useless.pixel = 0; empty_bitmap = gdk_bitmap_create_from_data (window, invisible_cursor_bits, 1, 1); cursor = gdk_cursor_new_from_pixmap (empty_bitmap, empty_bitmap, &useless, &useless, 0, 0); gdk_window_set_cursor (window, cursor); gdk_cursor_unref (cursor); g_object_unref (empty_bitmap); } static void gtk_entry_obscure_mouse_cursor (GtkEntry *entry) { if (entry->mouse_cursor_obscured) return; set_invisible_cursor (entry->text_area); entry->mouse_cursor_obscured = TRUE; } static gint gtk_entry_key_press (GtkWidget *widget, GdkEventKey *event) { GtkEntry *entry = GTK_ENTRY (widget); gtk_entry_reset_blink_time (entry); gtk_entry_pend_cursor_blink (entry); if (entry->editable) { if (gtk_im_context_filter_keypress (entry->im_context, event)) { gtk_entry_obscure_mouse_cursor (entry); entry->need_im_reset = TRUE; return TRUE; } } if (event->keyval == GDK_Return || event->keyval == GDK_KP_Enter || event->keyval == GDK_ISO_Enter || event->keyval == GDK_Escape) { GtkEntryCompletion *completion = gtk_entry_get_completion (entry); if (completion && completion->priv->completion_timeout) { g_source_remove (completion->priv->completion_timeout); completion->priv->completion_timeout = 0; } _gtk_entry_reset_im_context (entry); } if (GTK_WIDGET_CLASS (gtk_entry_parent_class)->key_press_event (widget, event)) /* Activate key bindings */ return TRUE; if (!entry->editable && event->length) gtk_widget_error_bell (widget); return FALSE; } static gint gtk_entry_key_release (GtkWidget *widget, GdkEventKey *event) { GtkEntry *entry = GTK_ENTRY (widget); if (entry->editable) { if (gtk_im_context_filter_keypress (entry->im_context, event)) { entry->need_im_reset = TRUE; return TRUE; } } return GTK_WIDGET_CLASS (gtk_entry_parent_class)->key_release_event (widget, event); } static gint gtk_entry_focus_in (GtkWidget *widget, GdkEventFocus *event) { GtkEntry *entry = GTK_ENTRY (widget); gtk_widget_queue_draw (widget); if (entry->editable) { entry->need_im_reset = TRUE; gtk_im_context_focus_in (entry->im_context); } g_signal_connect (gdk_keymap_get_for_display (gtk_widget_get_display (widget)), "direction_changed", G_CALLBACK (gtk_entry_keymap_direction_changed), entry); gtk_entry_reset_blink_time (entry); gtk_entry_check_cursor_blink (entry); return FALSE; } static gint gtk_entry_focus_out (GtkWidget *widget, GdkEventFocus *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryCompletion *completion; gtk_widget_queue_draw (widget); if (entry->editable) { entry->need_im_reset = TRUE; gtk_im_context_focus_out (entry->im_context); } gtk_entry_check_cursor_blink (entry); g_signal_handlers_disconnect_by_func (gdk_keymap_get_for_display (gtk_widget_get_display (widget)), gtk_entry_keymap_direction_changed, entry); completion = gtk_entry_get_completion (entry); if (completion) _gtk_entry_completion_popdown (completion); return FALSE; } static void gtk_entry_grab_focus (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); gboolean select_on_focus; GTK_WIDGET_CLASS (gtk_entry_parent_class)->grab_focus (widget); if (entry->editable && !entry->in_click) { g_object_get (gtk_widget_get_settings (widget), "gtk-entry-select-on-focus", &select_on_focus, NULL); if (select_on_focus) gtk_editable_select_region (GTK_EDITABLE (widget), 0, -1); } } static void gtk_entry_direction_changed (GtkWidget *widget, GtkTextDirection previous_dir) { GtkEntry *entry = GTK_ENTRY (widget); gtk_entry_recompute (entry); GTK_WIDGET_CLASS (gtk_entry_parent_class)->direction_changed (widget, previous_dir); } static void gtk_entry_state_changed (GtkWidget *widget, GtkStateType previous_state) { GtkEntry *entry = GTK_ENTRY (widget); GdkCursor *cursor; if (GTK_WIDGET_REALIZED (widget)) { gdk_window_set_background (widget->window, &widget->style->base[GTK_WIDGET_STATE (widget)]); gdk_window_set_background (entry->text_area, &widget->style->base[GTK_WIDGET_STATE (widget)]); 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 (entry->text_area, cursor); if (cursor) gdk_cursor_unref (cursor); entry->mouse_cursor_obscured = FALSE; } if (!GTK_WIDGET_IS_SENSITIVE (widget)) { /* Clear any selection */ gtk_editable_select_region (GTK_EDITABLE (entry), entry->current_pos, entry->current_pos); } gtk_widget_queue_draw (widget); } static void gtk_entry_screen_changed (GtkWidget *widget, GdkScreen *old_screen) { gtk_entry_recompute (GTK_ENTRY (widget)); } /* GtkEditable method implementations */ static void gtk_entry_insert_text (GtkEditable *editable, const gchar *new_text, gint new_text_length, gint *position) { GtkEntry *entry = GTK_ENTRY (editable); gchar buf[64]; gchar *text; if (*position < 0 || *position > entry->text_length) *position = entry->text_length; g_object_ref (editable); if (new_text_length <= 63) text = buf; else text = g_new (gchar, new_text_length + 1); text[new_text_length] = '\0'; strncpy (text, new_text, new_text_length); g_signal_emit_by_name (editable, "insert_text", text, new_text_length, position); if (!entry->visible) trash_area (text, new_text_length); if (new_text_length > 63) g_free (text); g_object_unref (editable); } static void gtk_entry_delete_text (GtkEditable *editable, gint start_pos, gint end_pos) { GtkEntry *entry = GTK_ENTRY (editable); if (end_pos < 0 || end_pos > entry->text_length) end_pos = entry->text_length; if (start_pos < 0) start_pos = 0; if (start_pos > end_pos) start_pos = end_pos; g_object_ref (editable); g_signal_emit_by_name (editable, "delete_text", start_pos, end_pos); g_object_unref (editable); } static gchar * gtk_entry_get_chars (GtkEditable *editable, gint start_pos, gint end_pos) { GtkEntry *entry = GTK_ENTRY (editable); gint start_index, end_index; if (end_pos < 0) end_pos = entry->text_length; start_pos = MIN (entry->text_length, start_pos); end_pos = MIN (entry->text_length, end_pos); start_index = g_utf8_offset_to_pointer (entry->text, start_pos) - entry->text; end_index = g_utf8_offset_to_pointer (entry->text, end_pos) - entry->text; return g_strndup (entry->text + start_index, end_index - start_index); } static void gtk_entry_real_set_position (GtkEditable *editable, gint position) { GtkEntry *entry = GTK_ENTRY (editable); if (position < 0 || position > entry->text_length) position = entry->text_length; if (position != entry->current_pos || position != entry->selection_bound) { _gtk_entry_reset_im_context (entry); gtk_entry_set_positions (entry, position, position); } } static gint gtk_entry_get_position (GtkEditable *editable) { return GTK_ENTRY (editable)->current_pos; } static void gtk_entry_set_selection_bounds (GtkEditable *editable, gint start, gint end) { GtkEntry *entry = GTK_ENTRY (editable); if (start < 0) start = entry->text_length; if (end < 0) end = entry->text_length; _gtk_entry_reset_im_context (entry); gtk_entry_set_positions (entry, MIN (end, entry->text_length), MIN (start, entry->text_length)); gtk_entry_update_primary_selection (entry); } static gboolean gtk_entry_get_selection_bounds (GtkEditable *editable, gint *start, gint *end) { GtkEntry *entry = GTK_ENTRY (editable); *start = entry->selection_bound; *end = entry->current_pos; return (entry->selection_bound != entry->current_pos); } static void gtk_entry_style_set (GtkWidget *widget, GtkStyle *previous_style) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); gint focus_width; gboolean interior_focus; gtk_widget_style_get (widget, "focus-line-width", &focus_width, "interior-focus", &interior_focus, NULL); priv->focus_width = focus_width; priv->interior_focus = interior_focus; gtk_entry_recompute (entry); if (previous_style && GTK_WIDGET_REALIZED (widget)) { gdk_window_set_background (widget->window, &widget->style->base[GTK_WIDGET_STATE (widget)]); gdk_window_set_background (entry->text_area, &widget->style->base[GTK_WIDGET_STATE (widget)]); } } /* GtkCellEditable method implementations */ static void gtk_cell_editable_entry_activated (GtkEntry *entry, gpointer data) { gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (entry)); gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (entry)); } static gboolean gtk_cell_editable_key_press_event (GtkEntry *entry, GdkEventKey *key_event, gpointer data) { if (key_event->keyval == GDK_Escape) { entry->editing_canceled = TRUE; gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (entry)); gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (entry)); return TRUE; } /* override focus */ if (key_event->keyval == GDK_Up || key_event->keyval == GDK_Down) { gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (entry)); gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (entry)); return TRUE; } return FALSE; } static void gtk_entry_start_editing (GtkCellEditable *cell_editable, GdkEvent *event) { GTK_ENTRY (cell_editable)->is_cell_renderer = TRUE; g_signal_connect (cell_editable, "activate", G_CALLBACK (gtk_cell_editable_entry_activated), NULL); g_signal_connect (cell_editable, "key_press_event", G_CALLBACK (gtk_cell_editable_key_press_event), NULL); } static void gtk_entry_password_hint_free (GtkEntryPasswordHint *password_hint) { if (password_hint->password_hint_timeout_id) g_source_remove (password_hint->password_hint_timeout_id); g_slice_free (GtkEntryPasswordHint, password_hint); } /* Default signal handlers */ static void gtk_entry_real_insert_text (GtkEditable *editable, const gchar *new_text, gint new_text_length, gint *position) { GtkEntry *entry = GTK_ENTRY (editable); gint index; gint n_chars; if (new_text_length < 0) new_text_length = strlen (new_text); n_chars = g_utf8_strlen (new_text, new_text_length); if (entry->text_max_length > 0 && n_chars + entry->text_length > entry->text_max_length) { gtk_widget_error_bell (GTK_WIDGET (entry)); n_chars = entry->text_max_length - entry->text_length; new_text_length = g_utf8_offset_to_pointer (new_text, n_chars) - new_text; } if (new_text_length + entry->n_bytes + 1 > entry->text_size) { gsize prev_size = entry->text_size; while (new_text_length + entry->n_bytes + 1 > entry->text_size) { if (entry->text_size == 0) entry->text_size = MIN_SIZE; else { if (2 * (guint)entry->text_size < MAX_SIZE && 2 * (guint)entry->text_size > entry->text_size) entry->text_size *= 2; else { entry->text_size = MAX_SIZE; if (new_text_length > (gint)entry->text_size - (gint)entry->n_bytes - 1) { new_text_length = (gint)entry->text_size - (gint)entry->n_bytes - 1; new_text_length = g_utf8_find_prev_char (new_text, new_text + new_text_length + 1) - new_text; n_chars = g_utf8_strlen (new_text, new_text_length); } break; } } } if (entry->visible) entry->text = g_realloc (entry->text, entry->text_size); else { /* Same thing, just slower and without leaving stuff in memory. */ gchar *et_new = g_malloc (entry->text_size); memcpy (et_new, entry->text, MIN (prev_size, entry->text_size)); trash_area (entry->text, prev_size); g_free (entry->text); entry->text = et_new; } } index = g_utf8_offset_to_pointer (entry->text, *position) - entry->text; g_memmove (entry->text + index + new_text_length, entry->text + index, entry->n_bytes - index); memcpy (entry->text + index, new_text, new_text_length); entry->n_bytes += new_text_length; entry->text_length += n_chars; /* NUL terminate for safety and convenience */ entry->text[entry->n_bytes] = '\0'; if (entry->current_pos > *position) entry->current_pos += n_chars; if (entry->selection_bound > *position) entry->selection_bound += n_chars; if (n_chars == 1 && !entry->visible && (new_text_length < PASSWORD_HINT_MAX)) { guint password_hint_timeout; g_object_get (gtk_widget_get_settings (GTK_WIDGET (entry)), "gtk-entry-password-hint-timeout", &password_hint_timeout, NULL); if (password_hint_timeout > 0) { GtkEntryPasswordHint *password_hint = g_object_get_qdata (G_OBJECT (entry), quark_password_hint); if (!password_hint) { password_hint = g_slice_new0 (GtkEntryPasswordHint); g_object_set_qdata_full (G_OBJECT (entry), quark_password_hint, password_hint, (GDestroyNotify) gtk_entry_password_hint_free); } memset (&password_hint->password_hint, 0x0, PASSWORD_HINT_MAX); password_hint->password_hint_length = new_text_length; memcpy (&password_hint->password_hint, new_text, new_text_length); password_hint->password_hint_position = *position + n_chars; } } else { g_object_set_qdata (G_OBJECT (entry), quark_password_hint, NULL); } *position += n_chars; gtk_entry_recompute (entry); emit_changed (entry); g_object_notify (G_OBJECT (editable), "text"); } static void gtk_entry_real_delete_text (GtkEditable *editable, gint start_pos, gint end_pos) { GtkEntry *entry = GTK_ENTRY (editable); if (start_pos < 0) start_pos = 0; if (end_pos < 0 || end_pos > entry->text_length) end_pos = entry->text_length; if (start_pos < end_pos) { gint start_index = g_utf8_offset_to_pointer (entry->text, start_pos) - entry->text; gint end_index = g_utf8_offset_to_pointer (entry->text, end_pos) - entry->text; gint current_pos; gint selection_bound; g_memmove (entry->text + start_index, entry->text + end_index, entry->n_bytes + 1 - end_index); entry->text_length -= (end_pos - start_pos); entry->n_bytes -= (end_index - start_index); /* In password-mode, make sure we don't leave anything sensitive after * the terminating zero. Note, that the terminating zero already trashed * one byte. */ if (!entry->visible) trash_area (entry->text + entry->n_bytes + 1, end_index - start_index - 1); current_pos = entry->current_pos; if (current_pos > start_pos) current_pos -= MIN (current_pos, end_pos) - start_pos; selection_bound = entry->selection_bound; if (selection_bound > start_pos) selection_bound -= MIN (selection_bound, end_pos) - start_pos; gtk_entry_set_positions (entry, current_pos, selection_bound); /* We might have deleted the selection */ gtk_entry_update_primary_selection (entry); gtk_entry_recompute (entry); emit_changed (entry); g_object_notify (G_OBJECT (editable), "text"); } } /* Compute the X position for an offset that corresponds to the "more important * cursor position for that offset. We use this when trying to guess to which * end of the selection we should go to when the user hits the left or * right arrow key. */ static gint get_better_cursor_x (GtkEntry *entry, gint offset) { GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (entry))); PangoDirection keymap_direction = gdk_keymap_get_direction (keymap); gboolean split_cursor; PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); const gchar *text = pango_layout_get_text (layout); gint index = g_utf8_offset_to_pointer (text, offset) - text; PangoRectangle strong_pos, weak_pos; g_object_get (gtk_widget_get_settings (GTK_WIDGET (entry)), "gtk-split-cursor", &split_cursor, NULL); pango_layout_get_cursor_pos (layout, index, &strong_pos, &weak_pos); if (split_cursor) return strong_pos.x / PANGO_SCALE; else return (keymap_direction == entry->resolved_dir) ? strong_pos.x / PANGO_SCALE : weak_pos.x / PANGO_SCALE; } static void gtk_entry_move_cursor (GtkEntry *entry, GtkMovementStep step, gint count, gboolean extend_selection) { gint new_pos = entry->current_pos; _gtk_entry_reset_im_context (entry); if (entry->current_pos != entry->selection_bound && !extend_selection) { /* If we have a current selection and aren't extending it, move to the * start/or end of the selection as appropriate */ switch (step) { case GTK_MOVEMENT_VISUAL_POSITIONS: { gint current_x = get_better_cursor_x (entry, entry->current_pos); gint bound_x = get_better_cursor_x (entry, entry->selection_bound); if (count <= 0) new_pos = current_x < bound_x ? entry->current_pos : entry->selection_bound; else new_pos = current_x > bound_x ? entry->current_pos : entry->selection_bound; break; } case GTK_MOVEMENT_LOGICAL_POSITIONS: case GTK_MOVEMENT_WORDS: if (count < 0) new_pos = MIN (entry->current_pos, entry->selection_bound); else new_pos = MAX (entry->current_pos, entry->selection_bound); break; case GTK_MOVEMENT_DISPLAY_LINE_ENDS: case GTK_MOVEMENT_PARAGRAPH_ENDS: case GTK_MOVEMENT_BUFFER_ENDS: new_pos = count < 0 ? 0 : entry->text_length; break; case GTK_MOVEMENT_DISPLAY_LINES: case GTK_MOVEMENT_PARAGRAPHS: case GTK_MOVEMENT_PAGES: case GTK_MOVEMENT_HORIZONTAL_PAGES: break; } } else { switch (step) { case GTK_MOVEMENT_LOGICAL_POSITIONS: new_pos = gtk_entry_move_logically (entry, new_pos, count); break; case GTK_MOVEMENT_VISUAL_POSITIONS: new_pos = gtk_entry_move_visually (entry, new_pos, count); if (entry->current_pos == new_pos) { if (!extend_selection) { if (!gtk_widget_keynav_failed (GTK_WIDGET (entry), count > 0 ? GTK_DIR_RIGHT : GTK_DIR_LEFT)) { GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (entry)); if (toplevel) gtk_widget_child_focus (toplevel, count > 0 ? GTK_DIR_RIGHT : GTK_DIR_LEFT); } } else { gtk_widget_error_bell (GTK_WIDGET (entry)); } } break; case GTK_MOVEMENT_WORDS: while (count > 0) { new_pos = gtk_entry_move_forward_word (entry, new_pos, FALSE); count--; } while (count < 0) { new_pos = gtk_entry_move_backward_word (entry, new_pos, FALSE); count++; } if (entry->current_pos == new_pos) gtk_widget_error_bell (GTK_WIDGET (entry)); break; case GTK_MOVEMENT_DISPLAY_LINE_ENDS: case GTK_MOVEMENT_PARAGRAPH_ENDS: case GTK_MOVEMENT_BUFFER_ENDS: new_pos = count < 0 ? 0 : entry->text_length; if (entry->current_pos == new_pos) gtk_widget_error_bell (GTK_WIDGET (entry)); break; case GTK_MOVEMENT_DISPLAY_LINES: case GTK_MOVEMENT_PARAGRAPHS: case GTK_MOVEMENT_PAGES: case GTK_MOVEMENT_HORIZONTAL_PAGES: break; } } if (extend_selection) gtk_editable_select_region (GTK_EDITABLE (entry), entry->selection_bound, new_pos); else gtk_editable_set_position (GTK_EDITABLE (entry), new_pos); gtk_entry_pend_cursor_blink (entry); } static void gtk_entry_insert_at_cursor (GtkEntry *entry, const gchar *str) { GtkEditable *editable = GTK_EDITABLE (entry); gint pos = entry->current_pos; if (entry->editable) { _gtk_entry_reset_im_context (entry); gtk_editable_insert_text (editable, str, -1, &pos); gtk_editable_set_position (editable, pos); } } static void gtk_entry_delete_from_cursor (GtkEntry *entry, GtkDeleteType type, gint count) { GtkEditable *editable = GTK_EDITABLE (entry); gint start_pos = entry->current_pos; gint end_pos = entry->current_pos; gint old_n_bytes = entry->n_bytes; _gtk_entry_reset_im_context (entry); if (!entry->editable) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } if (entry->selection_bound != entry->current_pos) { gtk_editable_delete_selection (editable); return; } switch (type) { case GTK_DELETE_CHARS: end_pos = gtk_entry_move_logically (entry, entry->current_pos, count); gtk_editable_delete_text (editable, MIN (start_pos, end_pos), MAX (start_pos, end_pos)); break; case GTK_DELETE_WORDS: if (count < 0) { /* Move to end of current word, or if not on a word, end of previous word */ end_pos = gtk_entry_move_backward_word (entry, end_pos, FALSE); end_pos = gtk_entry_move_forward_word (entry, end_pos, FALSE); } else if (count > 0) { /* Move to beginning of current word, or if not on a word, begining of next word */ start_pos = gtk_entry_move_forward_word (entry, start_pos, FALSE); start_pos = gtk_entry_move_backward_word (entry, start_pos, FALSE); } /* Fall through */ case GTK_DELETE_WORD_ENDS: while (count < 0) { start_pos = gtk_entry_move_backward_word (entry, start_pos, FALSE); count++; } while (count > 0) { end_pos = gtk_entry_move_forward_word (entry, end_pos, FALSE); count--; } gtk_editable_delete_text (editable, start_pos, end_pos); break; case GTK_DELETE_DISPLAY_LINE_ENDS: case GTK_DELETE_PARAGRAPH_ENDS: if (count < 0) gtk_editable_delete_text (editable, 0, entry->current_pos); else gtk_editable_delete_text (editable, entry->current_pos, -1); break; case GTK_DELETE_DISPLAY_LINES: case GTK_DELETE_PARAGRAPHS: gtk_editable_delete_text (editable, 0, -1); break; case GTK_DELETE_WHITESPACE: gtk_entry_delete_whitespace (entry); break; } if (entry->n_bytes == old_n_bytes) gtk_widget_error_bell (GTK_WIDGET (entry)); gtk_entry_pend_cursor_blink (entry); } static void gtk_entry_backspace (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); gint prev_pos; _gtk_entry_reset_im_context (entry); if (!entry->editable || !entry->text) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } if (entry->selection_bound != entry->current_pos) { gtk_editable_delete_selection (editable); return; } prev_pos = gtk_entry_move_logically(entry, entry->current_pos, -1); if (prev_pos < entry->current_pos) { PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); PangoLogAttr *log_attrs; gint n_attrs; pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs); if (log_attrs[entry->current_pos].backspace_deletes_character) { gchar *cluster_text; gchar *normalized_text; glong len; cluster_text = gtk_editable_get_chars (editable, prev_pos, entry->current_pos); normalized_text = g_utf8_normalize (cluster_text, strlen (cluster_text), G_NORMALIZE_NFD); len = g_utf8_strlen (normalized_text, -1); gtk_editable_delete_text (editable, prev_pos, entry->current_pos); if (len > 1) { gint pos = entry->current_pos; gtk_editable_insert_text (editable, normalized_text, g_utf8_offset_to_pointer (normalized_text, len - 1) - normalized_text, &pos); gtk_editable_set_position (editable, pos); } g_free (normalized_text); g_free (cluster_text); } else { gtk_editable_delete_text (editable, prev_pos, entry->current_pos); } g_free (log_attrs); } else { gtk_widget_error_bell (GTK_WIDGET (entry)); } gtk_entry_pend_cursor_blink (entry); } static void gtk_entry_copy_clipboard (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; if (gtk_editable_get_selection_bounds (editable, &start, &end)) { gchar *str = gtk_entry_get_public_chars (entry, start, end); gtk_clipboard_set_text (gtk_widget_get_clipboard (GTK_WIDGET (entry), GDK_SELECTION_CLIPBOARD), str, -1); g_free (str); } } static void gtk_entry_cut_clipboard (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; gtk_entry_copy_clipboard (entry); if (entry->editable) { if (gtk_editable_get_selection_bounds (editable, &start, &end)) gtk_editable_delete_text (editable, start, end); } else { gtk_widget_error_bell (GTK_WIDGET (entry)); } } static void gtk_entry_paste_clipboard (GtkEntry *entry) { if (entry->editable) gtk_entry_paste (entry, GDK_NONE); else gtk_widget_error_bell (GTK_WIDGET (entry)); } static void gtk_entry_delete_cb (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; if (entry->editable) { if (gtk_editable_get_selection_bounds (editable, &start, &end)) gtk_editable_delete_text (editable, start, end); } } static void gtk_entry_toggle_overwrite (GtkEntry *entry) { entry->overwrite_mode = !entry->overwrite_mode; gtk_entry_pend_cursor_blink (entry); gtk_widget_queue_draw (GTK_WIDGET (entry)); } static void gtk_entry_select_all (GtkEntry *entry) { gtk_entry_select_line (entry); } static void gtk_entry_real_activate (GtkEntry *entry) { GtkWindow *window; GtkWidget *toplevel; GtkWidget *widget; widget = GTK_WIDGET (entry); if (entry->activates_default) { toplevel = gtk_widget_get_toplevel (widget); if (GTK_IS_WINDOW (toplevel)) { window = GTK_WINDOW (toplevel); if (window && widget != window->default_widget && !(widget == window->focus_widget && (!window->default_widget || !GTK_WIDGET_SENSITIVE (window->default_widget)))) gtk_window_activate_default (window); } } } static void gtk_entry_keymap_direction_changed (GdkKeymap *keymap, GtkEntry *entry) { gtk_entry_recompute (entry); } /* IM Context Callbacks */ static void gtk_entry_commit_cb (GtkIMContext *context, const gchar *str, GtkEntry *entry) { if (entry->editable) gtk_entry_enter_text (entry, str); } static void gtk_entry_preedit_changed_cb (GtkIMContext *context, GtkEntry *entry) { if (entry->editable) { gchar *preedit_string; gint cursor_pos; gtk_im_context_get_preedit_string (entry->im_context, &preedit_string, NULL, &cursor_pos); entry->preedit_length = strlen (preedit_string); cursor_pos = CLAMP (cursor_pos, 0, g_utf8_strlen (preedit_string, -1)); entry->preedit_cursor = cursor_pos; g_free (preedit_string); gtk_entry_recompute (entry); } } static gboolean gtk_entry_retrieve_surrounding_cb (GtkIMContext *context, GtkEntry *entry) { gtk_im_context_set_surrounding (context, entry->text, entry->n_bytes, g_utf8_offset_to_pointer (entry->text, entry->current_pos) - entry->text); return TRUE; } static gboolean gtk_entry_delete_surrounding_cb (GtkIMContext *slave, gint offset, gint n_chars, GtkEntry *entry) { if (entry->editable) gtk_editable_delete_text (GTK_EDITABLE (entry), entry->current_pos + offset, entry->current_pos + offset + n_chars); return TRUE; } /* Internal functions */ /* Used for im_commit_cb and inserting Unicode chars */ static void gtk_entry_enter_text (GtkEntry *entry, const gchar *str) { GtkEditable *editable = GTK_EDITABLE (entry); gint tmp_pos; gboolean old_need_im_reset; old_need_im_reset = entry->need_im_reset; entry->need_im_reset = FALSE; if (gtk_editable_get_selection_bounds (editable, NULL, NULL)) gtk_editable_delete_selection (editable); else { if (entry->overwrite_mode) gtk_entry_delete_from_cursor (entry, GTK_DELETE_CHARS, 1); } tmp_pos = entry->current_pos; gtk_editable_insert_text (editable, str, strlen (str), &tmp_pos); gtk_editable_set_position (editable, tmp_pos); entry->need_im_reset = old_need_im_reset; } /* All changes to entry->current_pos and entry->selection_bound * should go through this function. */ static void gtk_entry_set_positions (GtkEntry *entry, gint current_pos, gint selection_bound) { gboolean changed = FALSE; g_object_freeze_notify (G_OBJECT (entry)); if (current_pos != -1 && entry->current_pos != current_pos) { entry->current_pos = current_pos; changed = TRUE; g_object_notify (G_OBJECT (entry), "cursor-position"); } if (selection_bound != -1 && entry->selection_bound != selection_bound) { entry->selection_bound = selection_bound; changed = TRUE; g_object_notify (G_OBJECT (entry), "selection-bound"); } g_object_thaw_notify (G_OBJECT (entry)); if (changed) { gtk_entry_move_adjustments (entry); gtk_entry_recompute (entry); } } static void gtk_entry_reset_layout (GtkEntry *entry) { if (entry->cached_layout) { g_object_unref (entry->cached_layout); entry->cached_layout = NULL; } } static void update_im_cursor_location (GtkEntry *entry) { GdkRectangle area; gint strong_x; gint strong_xoffset; gint area_width, area_height; gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &strong_x, NULL) ; get_text_area_size (entry, NULL, NULL, &area_width, &area_height); strong_xoffset = strong_x - entry->scroll_offset; if (strong_xoffset < 0) { strong_xoffset = 0; } else if (strong_xoffset > area_width) { strong_xoffset = area_width; } area.x = strong_xoffset; area.y = 0; area.width = 0; area.height = area_height; gtk_im_context_set_cursor_location (entry->im_context, &area); } static gboolean recompute_idle_func (gpointer data) { GtkEntry *entry; entry = GTK_ENTRY (data); entry->recompute_idle = 0; if (gtk_widget_has_screen (GTK_WIDGET (entry))) { gtk_entry_adjust_scroll (entry); gtk_entry_queue_draw (entry); update_im_cursor_location (entry); } return FALSE; } static void gtk_entry_recompute (GtkEntry *entry) { gtk_entry_reset_layout (entry); gtk_entry_check_cursor_blink (entry); if (!entry->recompute_idle) { entry->recompute_idle = gdk_threads_add_idle_full (G_PRIORITY_HIGH_IDLE + 15, /* between resize and redraw */ recompute_idle_func, entry, NULL); } } static void append_char (GString *str, gunichar ch, gint count) { gint i; gint char_len; gchar buf[7]; char_len = g_unichar_to_utf8 (ch, buf); i = 0; while (i < count) { g_string_append_len (str, buf, char_len); ++i; } } static gboolean gtk_entry_remove_password_hint (gpointer data) { /* Force the string to be redrawn, but now without a visible character */ gtk_entry_recompute (GTK_ENTRY (data)); return FALSE; } static PangoLayout * gtk_entry_create_layout (GtkEntry *entry, gboolean include_preedit) { GtkWidget *widget = GTK_WIDGET (entry); PangoLayout *layout = gtk_widget_create_pango_layout (widget, NULL); PangoAttrList *tmp_attrs = pango_attr_list_new (); gchar *preedit_string = NULL; gint preedit_length = 0; PangoAttrList *preedit_attrs = NULL; pango_layout_set_single_paragraph_mode (layout, TRUE); if (include_preedit) { gtk_im_context_get_preedit_string (entry->im_context, &preedit_string, &preedit_attrs, NULL); preedit_length = entry->preedit_length; } if (preedit_length) { GString *tmp_string = g_string_new (NULL); gint cursor_index = g_utf8_offset_to_pointer (entry->text, entry->current_pos) - entry->text; if (entry->visible) { g_string_prepend_len (tmp_string, entry->text, entry->n_bytes); g_string_insert (tmp_string, cursor_index, preedit_string); } else { gint ch_len; gint preedit_len_chars; gunichar invisible_char; ch_len = g_utf8_strlen (entry->text, entry->n_bytes); preedit_len_chars = g_utf8_strlen (preedit_string, -1); ch_len += preedit_len_chars; if (entry->invisible_char != 0) invisible_char = entry->invisible_char; else invisible_char = ' '; /* just pick a char */ append_char (tmp_string, invisible_char, ch_len); /* Fix cursor index to point to invisible char corresponding * to the preedit, fix preedit_length to be the length of * the invisible chars representing the preedit */ cursor_index = g_utf8_offset_to_pointer (tmp_string->str, entry->current_pos) - tmp_string->str; preedit_length = preedit_len_chars * g_unichar_to_utf8 (invisible_char, NULL); } pango_layout_set_text (layout, tmp_string->str, tmp_string->len); pango_attr_list_splice (tmp_attrs, preedit_attrs, cursor_index, preedit_length); g_string_free (tmp_string, TRUE); } else { PangoDirection pango_dir; if (entry->visible) pango_dir = pango_find_base_dir (entry->text, entry->n_bytes); else pango_dir = PANGO_DIRECTION_NEUTRAL; if (pango_dir == PANGO_DIRECTION_NEUTRAL) { if (GTK_WIDGET_HAS_FOCUS (widget)) { GdkDisplay *display = gtk_widget_get_display (widget); GdkKeymap *keymap = gdk_keymap_get_for_display (display); if (gdk_keymap_get_direction (keymap) == PANGO_DIRECTION_RTL) pango_dir = PANGO_DIRECTION_RTL; else pango_dir = PANGO_DIRECTION_LTR; } else { if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL) pango_dir = PANGO_DIRECTION_RTL; else pango_dir = PANGO_DIRECTION_LTR; } } pango_context_set_base_dir (gtk_widget_get_pango_context (widget), pango_dir); pango_layout_set_alignment (layout, pango_dir); entry->resolved_dir = pango_dir; if (entry->visible) { pango_layout_set_text (layout, entry->text, entry->n_bytes); } else { GString *str = g_string_new (NULL); gunichar invisible_char; guint password_hint_timeout; GtkEntryPasswordHint *password_hint; g_object_get (gtk_widget_get_settings (widget), "gtk-entry-password-hint-timeout", &password_hint_timeout, NULL); if (entry->invisible_char != 0) invisible_char = entry->invisible_char; else invisible_char = ' '; /* just pick a char */ password_hint = g_object_get_qdata (G_OBJECT (entry), quark_password_hint); if (password_hint && password_hint->password_hint_timeout_id) { g_source_remove (password_hint->password_hint_timeout_id); password_hint->password_hint_timeout_id = 0; } if (password_hint_timeout == 0 || password_hint == NULL || (password_hint && password_hint->password_hint_length == 0)) { append_char (str, invisible_char, entry->text_length); } else if (password_hint) { /* Draw hidden characters upto the inserted position, * then the real thing, pad up to full length */ if (password_hint->password_hint_position > 1) append_char (str, invisible_char, password_hint->password_hint_position - 1); g_string_append_len (str, password_hint->password_hint, password_hint->password_hint_length); if (password_hint->password_hint_position < entry->text_length) append_char (str, invisible_char, entry->text_length - password_hint->password_hint_position); /* Now remove this last input character, don't need * it anymore */ memset (password_hint->password_hint, 0, PASSWORD_HINT_MAX); password_hint->password_hint_length = 0; password_hint->password_hint_timeout_id = gdk_threads_add_timeout (password_hint_timeout, (GSourceFunc) gtk_entry_remove_password_hint, entry); } pango_layout_set_text (layout, str->str, str->len); g_string_free (str, TRUE); } } pango_layout_set_attributes (layout, tmp_attrs); g_free (preedit_string); if (preedit_attrs) pango_attr_list_unref (preedit_attrs); pango_attr_list_unref (tmp_attrs); return layout; } static PangoLayout * gtk_entry_ensure_layout (GtkEntry *entry, gboolean include_preedit) { if (entry->preedit_length > 0 && !include_preedit != !entry->cache_includes_preedit) gtk_entry_reset_layout (entry); if (!entry->cached_layout) { entry->cached_layout = gtk_entry_create_layout (entry, include_preedit); entry->cache_includes_preedit = include_preedit; } return entry->cached_layout; } static void get_layout_position (GtkEntry *entry, gint *x, gint *y) { PangoLayout *layout; PangoRectangle logical_rect; gint area_width, area_height; GtkBorder inner_border; gint y_pos; PangoLayoutLine *line; layout = gtk_entry_ensure_layout (entry, TRUE); get_text_area_size (entry, NULL, NULL, &area_width, &area_height); _gtk_entry_effective_inner_border (entry, &inner_border); area_height = PANGO_SCALE * (area_height - inner_border.top - inner_border.bottom); line = pango_layout_get_lines_readonly (layout)->data; pango_layout_line_get_extents (line, NULL, &logical_rect); /* Align primarily for locale's ascent/descent */ y_pos = ((area_height - entry->ascent - entry->descent) / 2 + entry->ascent + logical_rect.y); /* Now see if we need to adjust to fit in actual drawn string */ if (logical_rect.height > area_height) y_pos = (area_height - logical_rect.height) / 2; else if (y_pos < 0) y_pos = 0; else if (y_pos + logical_rect.height > area_height) y_pos = area_height - logical_rect.height; y_pos = inner_border.top + y_pos / PANGO_SCALE; if (x) *x = inner_border.left - entry->scroll_offset; if (y) *y = y_pos; } static void gtk_entry_draw_text (GtkEntry *entry) { GtkWidget *widget; if (!entry->visible && entry->invisible_char == 0) return; if (GTK_WIDGET_DRAWABLE (entry)) { PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); cairo_t *cr; gint x, y; gint start_pos, end_pos; widget = GTK_WIDGET (entry); get_layout_position (entry, &x, &y); cr = gdk_cairo_create (entry->text_area); cairo_move_to (cr, x, y); gdk_cairo_set_source_color (cr, &widget->style->text [widget->state]); pango_cairo_show_layout (cr, layout); if (gtk_editable_get_selection_bounds (GTK_EDITABLE (entry), &start_pos, &end_pos)) { gint *ranges; gint n_ranges, i; PangoRectangle logical_rect; GdkColor *selection_color, *text_color; GtkBorder inner_border; pango_layout_get_pixel_extents (layout, NULL, &logical_rect); gtk_entry_get_pixel_ranges (entry, &ranges, &n_ranges); if (GTK_WIDGET_HAS_FOCUS (entry)) { selection_color = &widget->style->base [GTK_STATE_SELECTED]; text_color = &widget->style->text [GTK_STATE_SELECTED]; } else { selection_color = &widget->style->base [GTK_STATE_ACTIVE]; text_color = &widget->style->text [GTK_STATE_ACTIVE]; } _gtk_entry_effective_inner_border (entry, &inner_border); for (i = 0; i < n_ranges; ++i) cairo_rectangle (cr, inner_border.left - entry->scroll_offset + ranges[2 * i], y, ranges[2 * i + 1], logical_rect.height); cairo_clip (cr); gdk_cairo_set_source_color (cr, selection_color); cairo_paint (cr); cairo_move_to (cr, x, y); gdk_cairo_set_source_color (cr, text_color); pango_cairo_show_layout (cr, layout); g_free (ranges); } cairo_destroy (cr); } } static void draw_insertion_cursor (GtkEntry *entry, GdkRectangle *cursor_location, gboolean is_primary, PangoDirection direction, gboolean draw_arrow) { GtkWidget *widget = GTK_WIDGET (entry); GtkTextDirection text_dir; if (direction == PANGO_DIRECTION_LTR) text_dir = GTK_TEXT_DIR_LTR; else text_dir = GTK_TEXT_DIR_RTL; gtk_draw_insertion_cursor (widget, entry->text_area, NULL, cursor_location, is_primary, text_dir, draw_arrow); } static void gtk_entry_draw_cursor (GtkEntry *entry, CursorType type) { GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (entry))); PangoDirection keymap_direction = gdk_keymap_get_direction (keymap); if (GTK_WIDGET_DRAWABLE (entry)) { GtkWidget *widget = GTK_WIDGET (entry); GdkRectangle cursor_location; gboolean split_cursor; PangoRectangle cursor_rect; GtkBorder inner_border; gint xoffset; gint text_area_height; gint cursor_index; gboolean block; gboolean block_at_line_end; _gtk_entry_effective_inner_border (entry, &inner_border); xoffset = inner_border.left - entry->scroll_offset; gdk_drawable_get_size (entry->text_area, NULL, &text_area_height); cursor_index = g_utf8_offset_to_pointer (entry->text, entry->current_pos + entry->preedit_cursor) - entry->text; if (!entry->overwrite_mode) block = FALSE; else block = _gtk_text_util_get_block_cursor_location (gtk_entry_ensure_layout (entry, TRUE), cursor_index, &cursor_rect, &block_at_line_end); if (!block) { gint strong_x, weak_x; PangoDirection dir1 = PANGO_DIRECTION_NEUTRAL; PangoDirection dir2 = PANGO_DIRECTION_NEUTRAL; gint x1 = 0; gint x2 = 0; gtk_entry_get_cursor_locations (entry, type, &strong_x, &weak_x); g_object_get (gtk_widget_get_settings (widget), "gtk-split-cursor", &split_cursor, NULL); dir1 = entry->resolved_dir; if (split_cursor) { x1 = strong_x; if (weak_x != strong_x) { dir2 = (entry->resolved_dir == PANGO_DIRECTION_LTR) ? PANGO_DIRECTION_RTL : PANGO_DIRECTION_LTR; x2 = weak_x; } } else { if (keymap_direction == entry->resolved_dir) x1 = strong_x; else x1 = weak_x; } cursor_location.x = xoffset + x1; cursor_location.y = inner_border.top; cursor_location.width = 0; cursor_location.height = text_area_height - inner_border.top - inner_border.bottom; draw_insertion_cursor (entry, &cursor_location, TRUE, dir1, dir2 != PANGO_DIRECTION_NEUTRAL); if (dir2 != PANGO_DIRECTION_NEUTRAL) { cursor_location.x = xoffset + x2; draw_insertion_cursor (entry, &cursor_location, FALSE, dir2, TRUE); } } else /* overwrite_mode */ { PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); GdkColor cursor_color; GdkRectangle rect; cairo_t *cr; gint x, y; get_layout_position (entry, &x, &y); rect.x = PANGO_PIXELS (cursor_rect.x) + x; rect.y = PANGO_PIXELS (cursor_rect.y) + y; rect.width = PANGO_PIXELS (cursor_rect.width); rect.height = PANGO_PIXELS (cursor_rect.height); cr = gdk_cairo_create (entry->text_area); _gtk_widget_get_cursor_color (widget, &cursor_color); gdk_cairo_set_source_color (cr, &cursor_color); gdk_cairo_rectangle (cr, &rect); cairo_fill (cr); if (!block_at_line_end) { gdk_cairo_rectangle (cr, &rect); cairo_clip (cr); cairo_move_to (cr, x, y); gdk_cairo_set_source_color (cr, &widget->style->base[widget->state]); pango_cairo_show_layout (cr, layout); } cairo_destroy (cr); } } } static void gtk_entry_queue_draw (GtkEntry *entry) { if (GTK_WIDGET_DRAWABLE (entry)) gdk_window_invalidate_rect (entry->text_area, NULL, FALSE); } void _gtk_entry_reset_im_context (GtkEntry *entry) { if (entry->need_im_reset) { entry->need_im_reset = FALSE; gtk_im_context_reset (entry->im_context); } } static gint gtk_entry_find_position (GtkEntry *entry, gint x) { PangoLayout *layout; PangoLayoutLine *line; gint index; gint pos; gint trailing; const gchar *text; gint cursor_index; layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, entry->current_pos) - text; line = pango_layout_get_lines_readonly (layout)->data; pango_layout_line_x_to_index (line, x * PANGO_SCALE, &index, &trailing); if (index >= cursor_index && entry->preedit_length) { if (index >= cursor_index + entry->preedit_length) index -= entry->preedit_length; else { index = cursor_index; trailing = 0; } } pos = g_utf8_pointer_to_offset (text, text + index); pos += trailing; return pos; } static void gtk_entry_get_cursor_locations (GtkEntry *entry, CursorType type, gint *strong_x, gint *weak_x) { if (!entry->visible && !entry->invisible_char) { if (strong_x) *strong_x = 0; if (weak_x) *weak_x = 0; } else { PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); const gchar *text = pango_layout_get_text (layout); PangoRectangle strong_pos, weak_pos; gint index; if (type == CURSOR_STANDARD) { index = g_utf8_offset_to_pointer (text, entry->current_pos + entry->preedit_cursor) - text; } else /* type == CURSOR_DND */ { index = g_utf8_offset_to_pointer (text, entry->dnd_position) - text; if (entry->dnd_position > entry->current_pos) { if (entry->visible) index += entry->preedit_length; else { gint preedit_len_chars = g_utf8_strlen (text, -1) - entry->text_length; index += preedit_len_chars * g_unichar_to_utf8 (entry->invisible_char, NULL); } } } pango_layout_get_cursor_pos (layout, index, &strong_pos, &weak_pos); if (strong_x) *strong_x = strong_pos.x / PANGO_SCALE; if (weak_x) *weak_x = weak_pos.x / PANGO_SCALE; } } static void gtk_entry_adjust_scroll (GtkEntry *entry) { GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); gint min_offset, max_offset; gint text_area_width, text_width; GtkBorder inner_border; gint strong_x, weak_x; gint strong_xoffset, weak_xoffset; gfloat xalign; PangoLayout *layout; PangoLayoutLine *line; PangoRectangle logical_rect; if (!GTK_WIDGET_REALIZED (entry)) return; _gtk_entry_effective_inner_border (entry, &inner_border); gdk_drawable_get_size (entry->text_area, &text_area_width, NULL); text_area_width -= inner_border.left + inner_border.right; if (text_area_width < 0) text_area_width = 0; layout = gtk_entry_ensure_layout (entry, TRUE); line = pango_layout_get_lines_readonly (layout)->data; pango_layout_line_get_extents (line, NULL, &logical_rect); /* Display as much text as we can */ if (entry->resolved_dir == PANGO_DIRECTION_LTR) xalign = priv->xalign; else xalign = 1.0 - priv->xalign; text_width = PANGO_PIXELS(logical_rect.width); if (text_width > text_area_width) { min_offset = 0; max_offset = text_width - text_area_width; } else { min_offset = (text_width - text_area_width) * xalign; max_offset = min_offset; } entry->scroll_offset = CLAMP (entry->scroll_offset, min_offset, max_offset); /* And make sure cursors are on screen. Note that the cursor is * actually drawn one pixel into the INNER_BORDER space on * the right, when the scroll is at the utmost right. This * looks better to to me than confining the cursor inside the * border entirely, though it means that the cursor gets one * pixel closer to the edge of the widget on the right than * on the left. This might need changing if one changed * INNER_BORDER from 2 to 1, as one would do on a * small-screen-real-estate display. * * We always make sure that the strong cursor is on screen, and * put the weak cursor on screen if possible. */ gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &strong_x, &weak_x); strong_xoffset = strong_x - entry->scroll_offset; if (strong_xoffset < 0) { entry->scroll_offset += strong_xoffset; strong_xoffset = 0; } else if (strong_xoffset > text_area_width) { entry->scroll_offset += strong_xoffset - text_area_width; strong_xoffset = text_area_width; } weak_xoffset = weak_x - entry->scroll_offset; if (weak_xoffset < 0 && strong_xoffset - weak_xoffset <= text_area_width) { entry->scroll_offset += weak_xoffset; } else if (weak_xoffset > text_area_width && strong_xoffset - (weak_xoffset - text_area_width) >= 0) { entry->scroll_offset += weak_xoffset - text_area_width; } g_object_notify (G_OBJECT (entry), "scroll-offset"); } static void gtk_entry_move_adjustments (GtkEntry *entry) { PangoContext *context; PangoFontMetrics *metrics; gint x, layout_x, border_x, border_y; gint char_width; GtkAdjustment *adjustment; adjustment = g_object_get_qdata (G_OBJECT (entry), quark_cursor_hadjustment); if (!adjustment) return; /* Cursor position, layout offset, border width, and widget allocation */ gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &x, NULL); get_layout_position (entry, &layout_x, NULL); _gtk_entry_get_borders (entry, &border_x, &border_y); x += entry->widget.allocation.x + layout_x + border_x; /* Approximate width of a char, so user can see what is ahead/behind */ context = gtk_widget_get_pango_context (GTK_WIDGET (entry)); metrics = pango_context_get_metrics (context, entry->widget.style->font_desc, pango_context_get_language (context)); char_width = pango_font_metrics_get_approximate_char_width (metrics) / PANGO_SCALE; /* Scroll it */ gtk_adjustment_clamp_page (adjustment, x - (char_width + 1), /* one char + one pixel before */ x + (char_width + 2)); /* one char + cursor + one pixel after */ } static gint gtk_entry_move_visually (GtkEntry *entry, gint start, gint count) { gint index; PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); const gchar *text; text = pango_layout_get_text (layout); index = g_utf8_offset_to_pointer (text, start) - text; while (count != 0) { int new_index, new_trailing; gboolean split_cursor; gboolean strong; g_object_get (gtk_widget_get_settings (GTK_WIDGET (entry)), "gtk-split-cursor", &split_cursor, NULL); if (split_cursor) strong = TRUE; else { GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (entry))); PangoDirection keymap_direction = gdk_keymap_get_direction (keymap); strong = keymap_direction == entry->resolved_dir; } if (count > 0) { pango_layout_move_cursor_visually (layout, strong, index, 0, 1, &new_index, &new_trailing); count--; } else { pango_layout_move_cursor_visually (layout, strong, index, 0, -1, &new_index, &new_trailing); count++; } if (new_index < 0) index = 0; else if (new_index != G_MAXINT) index = new_index; while (new_trailing--) index = g_utf8_next_char (text + index) - text; } return g_utf8_pointer_to_offset (text, text + index); } static gint gtk_entry_move_logically (GtkEntry *entry, gint start, gint count) { gint new_pos = start; /* Prevent any leak of information */ if (!entry->visible) { new_pos = CLAMP (start + count, 0, entry->text_length); } else if (entry->text) { PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); PangoLogAttr *log_attrs; gint n_attrs; pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs); while (count > 0 && new_pos < entry->text_length) { do new_pos++; while (new_pos < entry->text_length && !log_attrs[new_pos].is_cursor_position); count--; } while (count < 0 && new_pos > 0) { do new_pos--; while (new_pos > 0 && !log_attrs[new_pos].is_cursor_position); count++; } g_free (log_attrs); } return new_pos; } static gint gtk_entry_move_forward_word (GtkEntry *entry, gint start, gboolean allow_whitespace) { gint new_pos = start; /* Prevent any leak of information */ if (!entry->visible) { new_pos = entry->text_length; } else if (entry->text && (new_pos < entry->text_length)) { PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); PangoLogAttr *log_attrs; gint n_attrs; pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs); /* Find the next word boundary */ new_pos++; while (new_pos < n_attrs - 1 && !(log_attrs[new_pos].is_word_end || (log_attrs[new_pos].is_word_start && allow_whitespace))) new_pos++; g_free (log_attrs); } return new_pos; } static gint gtk_entry_move_backward_word (GtkEntry *entry, gint start, gboolean allow_whitespace) { gint new_pos = start; /* Prevent any leak of information */ if (!entry->visible) { new_pos = 0; } else if (entry->text && start > 0) { PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); PangoLogAttr *log_attrs; gint n_attrs; pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs); new_pos = start - 1; /* Find the previous word boundary */ while (new_pos > 0 && !(log_attrs[new_pos].is_word_start || (log_attrs[new_pos].is_word_end && allow_whitespace))) new_pos--; g_free (log_attrs); } return new_pos; } static void gtk_entry_delete_whitespace (GtkEntry *entry) { PangoLayout *layout = gtk_entry_ensure_layout (entry, FALSE); PangoLogAttr *log_attrs; gint n_attrs; gint start, end; pango_layout_get_log_attrs (layout, &log_attrs, &n_attrs); start = end = entry->current_pos; while (start > 0 && log_attrs[start-1].is_white) start--; while (end < n_attrs && log_attrs[end].is_white) end++; g_free (log_attrs); if (start != end) gtk_editable_delete_text (GTK_EDITABLE (entry), start, end); } static void gtk_entry_select_word (GtkEntry *entry) { gint start_pos = gtk_entry_move_backward_word (entry, entry->current_pos, TRUE); gint end_pos = gtk_entry_move_forward_word (entry, entry->current_pos, TRUE); gtk_editable_select_region (GTK_EDITABLE (entry), start_pos, end_pos); } static void gtk_entry_select_line (GtkEntry *entry) { gtk_editable_select_region (GTK_EDITABLE (entry), 0, -1); } /* * Like gtk_editable_get_chars, but handle not-visible entries * correctly. */ static char * gtk_entry_get_public_chars (GtkEntry *entry, gint start, gint end) { if (end < 0) end = entry->text_length; if (entry->visible) return gtk_editable_get_chars (GTK_EDITABLE (entry), start, end); else if (!entry->invisible_char) return g_strdup (""); else { GString *str = g_string_new (NULL); append_char (str, entry->invisible_char, end - start); return g_string_free (str, FALSE); } } static gint truncate_multiline (const gchar *text) { gint length; for (length = 0; text[length] && text[length] != '\n' && text[length] != '\r'; length++); return length; } static void paste_received (GtkClipboard *clipboard, const gchar *text, gpointer data) { GtkEntry *entry = GTK_ENTRY (data); GtkEditable *editable = GTK_EDITABLE (entry); GtkEntryPrivate *priv = GTK_ENTRY_GET_PRIVATE (entry); if (entry->button == 2) { gint pos, start, end; pos = priv->insert_pos; gtk_editable_get_selection_bounds (editable, &start, &end); if (!((start <= pos && pos <= end) || (end <= pos && pos <= start))) gtk_editable_select_region (editable, pos, pos); } if (text) { gint pos, start, end; gint length = -1; gboolean popup_completion; GtkEntryCompletion *completion; completion = gtk_entry_get_completion (entry); if (entry->truncate_multiline) length = truncate_multiline (text); /* only complete if the selection is at the end */ popup_completion = (entry->text_length == MAX (entry->current_pos, entry->selection_bound)); if (completion) { if (GTK_WIDGET_MAPPED (completion->priv->popup_window)) _gtk_entry_completion_popdown (completion); if (!popup_completion && completion->priv->changed_id > 0) g_signal_handler_block (entry, completion->priv->changed_id); } begin_change (entry); g_object_freeze_notify (G_OBJECT (entry)); if (gtk_editable_get_selection_bounds (editable, &start, &end)) gtk_editable_delete_text (editable, start, end); pos = entry->current_pos; gtk_editable_insert_text (editable, text, length, &pos); gtk_editable_set_position (editable, pos); g_object_thaw_notify (G_OBJECT (entry)); end_change (entry); if (completion && !popup_completion && completion->priv->changed_id > 0) g_signal_handler_unblock (entry, completion->priv->changed_id); } g_object_unref (entry); } static void gtk_entry_paste (GtkEntry *entry, GdkAtom selection) { g_object_ref (entry); gtk_clipboard_request_text (gtk_widget_get_clipboard (GTK_WIDGET (entry), selection), paste_received, entry); } static void primary_get_cb (GtkClipboard *clipboard, GtkSelectionData *selection_data, guint info, gpointer data) { GtkEntry *entry = GTK_ENTRY (data); gint start, end; if (gtk_editable_get_selection_bounds (GTK_EDITABLE (entry), &start, &end)) { gchar *str = gtk_entry_get_public_chars (entry, start, end); gtk_selection_data_set_text (selection_data, str, -1); g_free (str); } } static void primary_clear_cb (GtkClipboard *clipboard, gpointer data) { GtkEntry *entry = GTK_ENTRY (data); gtk_editable_select_region (GTK_EDITABLE (entry), entry->current_pos, entry->current_pos); } static void gtk_entry_update_primary_selection (GtkEntry *entry) { GtkTargetList *list; GtkTargetEntry *targets; GtkClipboard *clipboard; gint start, end; gint n_targets; if (!GTK_WIDGET_REALIZED (entry)) return; list = gtk_target_list_new (NULL, 0); gtk_target_list_add_text_targets (list, 0); targets = gtk_target_table_new_from_list (list, &n_targets); clipboard = gtk_widget_get_clipboard (GTK_WIDGET (entry), GDK_SELECTION_PRIMARY); if (gtk_editable_get_selection_bounds (GTK_EDITABLE (entry), &start, &end)) { if (!gtk_clipboard_set_with_owner (clipboard, targets, n_targets, primary_get_cb, primary_clear_cb, G_OBJECT (entry))) primary_clear_cb (clipboard, entry); } else { if (gtk_clipboard_get_owner (clipboard) == G_OBJECT (entry)) gtk_clipboard_clear (clipboard); } gtk_target_table_free (targets, n_targets); gtk_target_list_unref (list); } /* Public API */ /** * gtk_entry_new: * * Creates a new entry. * * Return value: a new #GtkEntry. */ GtkWidget* gtk_entry_new (void) { return g_object_new (GTK_TYPE_ENTRY, NULL); } /** * gtk_entry_new_with_max_length: * @max: the maximum length of the entry, or 0 for no maximum. * (other than the maximum length of entries.) The value passed in will * be clamped to the range 0-65536. * * Creates a new #GtkEntry widget with the given maximum length. * * Note: the existence of this function is inconsistent * with the rest of the GTK+ API. The normal setup would * be to just require the user to make an extra call * to gtk_entry_set_max_length() instead. It is not * expected that this function will be removed, but * it would be better practice not to use it. * * Return value: a new #GtkEntry. **/ GtkWidget* gtk_entry_new_with_max_length (gint max) { GtkEntry *entry; max = CLAMP (max, 0, MAX_SIZE); entry = g_object_new (GTK_TYPE_ENTRY, NULL); entry->text_max_length = max; return GTK_WIDGET (entry); } /** * gtk_entry_set_text: * @entry: a #GtkEntry * @text: the new text * * Sets the text in the widget to the given * value, replacing the current contents. */ void gtk_entry_set_text (GtkEntry *entry, const gchar *text) { gint tmp_pos; GtkEntryCompletion *completion; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (text != NULL); /* Actually setting the text will affect the cursor and selection; * if the contents don't actually change, this will look odd to the user. */ if (strcmp (entry->text, text) == 0) return; completion = gtk_entry_get_completion (entry); if (completion && completion->priv->changed_id > 0) g_signal_handler_block (entry, completion->priv->changed_id); begin_change (entry); g_object_freeze_notify (G_OBJECT (entry)); gtk_editable_delete_text (GTK_EDITABLE (entry), 0, -1); tmp_pos = 0; gtk_editable_insert_text (GTK_EDITABLE (entry), text, strlen (text), &tmp_pos); g_object_thaw_notify (G_OBJECT (entry)); end_change (entry); if (completion && completion->priv->changed_id > 0) g_signal_handler_unblock (entry, completion->priv->changed_id); } /** * gtk_entry_append_text: * @entry: a #GtkEntry * @text: the text to append * * Appends the given text to the contents of the widget. * * Deprecated: 2.0: Use gtk_editable_insert_text() instead. */ void gtk_entry_append_text (GtkEntry *entry, const gchar *text) { gint tmp_pos; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (text != NULL); tmp_pos = entry->text_length; gtk_editable_insert_text (GTK_EDITABLE (entry), text, -1, &tmp_pos); } /** * gtk_entry_prepend_text: * @entry: a #GtkEntry * @text: the text to prepend * * Prepends the given text to the contents of the widget. * * Deprecated: 2.0: Use gtk_editable_insert_text() instead. */ void gtk_entry_prepend_text (GtkEntry *entry, const gchar *text) { gint tmp_pos; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (text != NULL); tmp_pos = 0; gtk_editable_insert_text (GTK_EDITABLE (entry), text, -1, &tmp_pos); } /** * gtk_entry_set_position: * @entry: a #GtkEntry * @position: the position of the cursor. The cursor is displayed * before the character with the given (base 0) index in the widget. * The value must be less than or equal to the number of characters * in the widget. A value of -1 indicates that the position should * be set after the last character in the entry. Note that this * position is in characters, not in bytes. * * Sets the cursor position in an entry to the given value. * * Deprecated: 2.0: Use gtk_editable_set_position() instead. */ void gtk_entry_set_position (GtkEntry *entry, gint position) { g_return_if_fail (GTK_IS_ENTRY (entry)); gtk_editable_set_position (GTK_EDITABLE (entry), position); } /** * gtk_entry_set_visibility: * @entry: a #GtkEntry * @visible: %TRUE if the contents of the entry are displayed * as plaintext * * Sets whether the contents of the entry are visible or not. * When visibility is set to %FALSE, characters are displayed * as the invisible char, and will also appear that way when * the text in the entry widget is copied elsewhere. * * The default invisible char is the asterisk '*', but it can * be changed with gtk_entry_set_invisible_char(). */ void gtk_entry_set_visibility (GtkEntry *entry, gboolean visible) { g_return_if_fail (GTK_IS_ENTRY (entry)); visible = visible != FALSE; if (entry->visible != visible) { if (GTK_WIDGET_HAS_FOCUS (entry) && !visible) gtk_im_context_focus_out (entry->im_context); g_object_unref (entry->im_context); if (visible) entry->im_context = gtk_im_multicontext_new (); else entry->im_context = gtk_im_context_simple_new (); g_signal_connect (entry->im_context, "commit", G_CALLBACK (gtk_entry_commit_cb), entry); g_signal_connect (entry->im_context, "preedit_changed", G_CALLBACK (gtk_entry_preedit_changed_cb), entry); g_signal_connect (entry->im_context, "retrieve_surrounding", G_CALLBACK (gtk_entry_retrieve_surrounding_cb), entry); g_signal_connect (entry->im_context, "delete_surrounding", G_CALLBACK (gtk_entry_delete_surrounding_cb), entry); if (GTK_WIDGET_HAS_FOCUS (entry) && visible) gtk_im_context_focus_in (entry->im_context); entry->visible = visible; g_object_notify (G_OBJECT (entry), "visibility"); gtk_entry_recompute (entry); } } /** * gtk_entry_get_visibility: * @entry: a #GtkEntry * * Retrieves whether the text in @entry is visible. See * gtk_entry_set_visibility(). * * Return value: %TRUE if the text is currently visible **/ gboolean gtk_entry_get_visibility (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); return entry->visible; } /** * gtk_entry_set_invisible_char: * @entry: a #GtkEntry * @ch: a Unicode character * * Sets the character to use in place of the actual text when * gtk_entry_set_visibility() has been called to set text visibility * to %FALSE. i.e. this is the character used in "password mode" to * show the user how many characters have been typed. The default * invisible char is an asterisk ('*'). If you set the invisible char * to 0, then the user will get no feedback at all; there will be * no text on the screen as they type. **/ void gtk_entry_set_invisible_char (GtkEntry *entry, gunichar ch) { g_return_if_fail (GTK_IS_ENTRY (entry)); if (ch == entry->invisible_char) return; entry->invisible_char = ch; g_object_notify (G_OBJECT (entry), "invisible-char"); gtk_entry_recompute (entry); } /** * gtk_entry_get_invisible_char: * @entry: a #GtkEntry * * Retrieves the character displayed in place of the real characters * for entries with visibility set to false. See gtk_entry_set_invisible_char(). * * Return value: the current invisible char, or 0, if the entry does not * show invisible text at all. **/ gunichar gtk_entry_get_invisible_char (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); return entry->invisible_char; } /** * gtk_entry_set_editable: * @entry: a #GtkEntry * @editable: %TRUE if the user is allowed to edit the text * in the widget * * Determines if the user can edit the text in the editable * widget or not. * * Deprecated: 2.0: Use gtk_editable_set_editable() instead. */ void gtk_entry_set_editable (GtkEntry *entry, gboolean editable) { g_return_if_fail (GTK_IS_ENTRY (entry)); gtk_editable_set_editable (GTK_EDITABLE (entry), editable); } /** * gtk_entry_set_overwrite_mode: * @entry: a #GtkEntry * @overwrite: new value * * Sets whether the text is overwritten when typing in the #GtkEntry. * * Since: 2.14 **/ void gtk_entry_set_overwrite_mode (GtkEntry *entry, gboolean overwrite) { g_return_if_fail (GTK_IS_ENTRY (entry)); if (entry->overwrite_mode == overwrite) return; gtk_entry_toggle_overwrite (entry); g_object_notify (G_OBJECT (entry), "overwrite-mode"); } /** * gtk_entry_get_overwrite_mode: * @entry: a #GtkEntry * * Gets the value set by gtk_entry_set_overwrite_mode(). * * Return value: whether the text is overwritten when typing. * * Since: 2.14 **/ gboolean gtk_entry_get_overwrite_mode (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); return entry->overwrite_mode; } /** * gtk_entry_get_text: * @entry: a #GtkEntry * * Retrieves the contents of the entry widget. * See also gtk_editable_get_chars(). * * Return value: a pointer to the contents of the widget as a * string. This string points to internally allocated * storage in the widget and must not be freed, modified or * stored. **/ G_CONST_RETURN gchar* gtk_entry_get_text (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return entry->text; } /** * gtk_entry_select_region: * @entry: a #GtkEntry * @start: the starting position * @end: the end position * * Selects a region of text. The characters that are selected are * those characters at positions from @start_pos up to, but not * including @end_pos. If @end_pos is negative, then the the characters * selected will be those characters from @start_pos to the end of * the text. * * Deprecated: 2.0: Use gtk_editable_select_region() instead. */ void gtk_entry_select_region (GtkEntry *entry, gint start, gint end) { gtk_editable_select_region (GTK_EDITABLE (entry), start, end); } /** * gtk_entry_set_max_length: * @entry: a #GtkEntry * @max: the maximum length of the entry, or 0 for no maximum. * (other than the maximum length of entries.) The value passed in will * be clamped to the range 0-65536. * * Sets the maximum allowed length of the contents of the widget. If * the current contents are longer than the given length, then they * will be truncated to fit. **/ void gtk_entry_set_max_length (GtkEntry *entry, gint max) { g_return_if_fail (GTK_IS_ENTRY (entry)); max = CLAMP (max, 0, MAX_SIZE); if (max > 0 && entry->text_length > max) gtk_editable_delete_text (GTK_EDITABLE (entry), max, -1); entry->text_max_length = max; g_object_notify (G_OBJECT (entry), "max-length"); } /** * gtk_entry_get_max_length: * @entry: a #GtkEntry * * Retrieves the maximum allowed length of the text in * @entry. See gtk_entry_set_max_length(). * * Return value: the maximum allowed number of characters * in #GtkEntry, or 0 if there is no maximum. **/ gint gtk_entry_get_max_length (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); return entry->text_max_length; } /** * gtk_entry_get_text_length: * @entry: a #GtkEntry * * Retrieves the current length of the text in * @entry. * * Return value: the current number of characters * in #GtkEntry, or 0 if there are none. * * Since: 2.14 **/ guint16 gtk_entry_get_text_length (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); return entry->text_length; } /** * gtk_entry_set_activates_default: * @entry: a #GtkEntry * @setting: %TRUE to activate window's default widget on Enter keypress * * If @setting is %TRUE, pressing Enter in the @entry will activate the default * widget for the window containing the entry. This usually means that * the dialog box containing the entry will be closed, since the default * widget is usually one of the dialog buttons. * * (For experts: if @setting is %TRUE, the entry calls * gtk_window_activate_default() on the window containing the entry, in * the default handler for the #GtkWidget::activate signal.) **/ void gtk_entry_set_activates_default (GtkEntry *entry, gboolean setting) { g_return_if_fail (GTK_IS_ENTRY (entry)); setting = setting != FALSE; if (setting != entry->activates_default) { entry->activates_default = setting; g_object_notify (G_OBJECT (entry), "activates-default"); } } /** * gtk_entry_get_activates_default: * @entry: a #GtkEntry * * Retrieves the value set by gtk_entry_set_activates_default(). * * Return value: %TRUE if the entry will activate the default widget **/ gboolean gtk_entry_get_activates_default (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); return entry->activates_default; } /** * gtk_entry_set_width_chars: * @entry: a #GtkEntry * @n_chars: width in chars * * Changes the size request of the entry to be about the right size * for @n_chars characters. Note that it changes the size * request, the size can still be affected by * how you pack the widget into containers. If @n_chars is -1, the * size reverts to the default entry size. **/ void gtk_entry_set_width_chars (GtkEntry *entry, gint n_chars) { g_return_if_fail (GTK_IS_ENTRY (entry)); if (entry->width_chars != n_chars) { entry->width_chars = n_chars; g_object_notify (G_OBJECT (entry), "width-chars"); gtk_widget_queue_resize (GTK_WIDGET (entry)); } } /** * gtk_entry_get_width_chars: * @entry: a #GtkEntry * * Gets the value set by gtk_entry_set_width_chars(). * * Return value: number of chars to request space for, or negative if unset **/ gint gtk_entry_get_width_chars (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); return entry->width_chars; } /** * gtk_entry_set_has_frame: * @entry: a #GtkEntry * @setting: new value * * Sets whether the entry has a beveled frame around it. **/ void gtk_entry_set_has_frame (GtkEntry *entry, gboolean setting) { g_return_if_fail (GTK_IS_ENTRY (entry)); setting = (setting != FALSE); if (entry->has_frame == setting) return; gtk_widget_queue_resize (GTK_WIDGET (entry)); entry->has_frame = setting; g_object_notify (G_OBJECT (entry), "has-frame"); } /** * gtk_entry_get_has_frame: * @entry: a #GtkEntry * * Gets the value set by gtk_entry_set_has_frame(). * * Return value: whether the entry has a beveled frame **/ gboolean gtk_entry_get_has_frame (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); return entry->has_frame; } /** * gtk_entry_set_inner_border: * @entry: a #GtkEntry * @border: a #GtkBorder, or %NULL * * Sets %entry's inner-border property to %border, or clears it if %NULL * is passed. The inner-border is the area around the entry's text, but * inside its frame. * * If set, this property overrides the inner-border style property. * Overriding the style-provided border is useful when you want to do * in-place editing of some text in a canvas or list widget, where * pixel-exact positioning of the entry is important. * * Since: 2.10 **/ void gtk_entry_set_inner_border (GtkEntry *entry, const GtkBorder *border) { g_return_if_fail (GTK_IS_ENTRY (entry)); gtk_widget_queue_resize (GTK_WIDGET (entry)); if (border) g_object_set_qdata_full (G_OBJECT (entry), quark_inner_border, gtk_border_copy (border), (GDestroyNotify) gtk_border_free); else g_object_set_qdata (G_OBJECT (entry), quark_inner_border, NULL); g_object_notify (G_OBJECT (entry), "inner-border"); } /** * gtk_entry_get_inner_border: * @entry: a #GtkEntry * * This function returns the entry's #GtkEntry:inner-border property. See * gtk_entry_set_inner_border() for more information. * * Return value: the entry's #GtkBorder, or %NULL if none was set. * * Since: 2.10 **/ G_CONST_RETURN GtkBorder * gtk_entry_get_inner_border (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return g_object_get_qdata (G_OBJECT (entry), quark_inner_border); } /** * gtk_entry_get_layout: * @entry: a #GtkEntry * * Gets the #PangoLayout used to display the entry. * The layout is useful to e.g. convert text positions to * pixel positions, in combination with gtk_entry_get_layout_offsets(). * The returned layout is owned by the entry and must not be * modified or freed by the caller. * * Keep in mind that the layout text may contain a preedit string, so * gtk_entry_layout_index_to_text_index() and * gtk_entry_text_index_to_layout_index() are needed to convert byte * indices in the layout to byte indices in the entry contents. * * Return value: the #PangoLayout for this entry **/ PangoLayout* gtk_entry_get_layout (GtkEntry *entry) { PangoLayout *layout; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); layout = gtk_entry_ensure_layout (entry, TRUE); return layout; } /** * gtk_entry_layout_index_to_text_index: * @entry: a #GtkEntry * @layout_index: byte index into the entry layout text * * Converts from a position in the entry contents (returned * by gtk_entry_get_text()) to a position in the * entry's #PangoLayout (returned by gtk_entry_get_layout(), * with text retrieved via pango_layout_get_text()). * * Return value: byte index into the entry contents **/ gint gtk_entry_layout_index_to_text_index (GtkEntry *entry, gint layout_index) { PangoLayout *layout; const gchar *text; gint cursor_index; g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, entry->current_pos) - text; if (layout_index >= cursor_index && entry->preedit_length) { if (layout_index >= cursor_index + entry->preedit_length) layout_index -= entry->preedit_length; else layout_index = cursor_index; } return layout_index; } /** * gtk_entry_text_index_to_layout_index: * @entry: a #GtkEntry * @text_index: byte index into the entry contents * * Converts from a position in the entry's #PangoLayout (returned by * gtk_entry_get_layout()) to a position in the entry contents * (returned by gtk_entry_get_text()). * * Return value: byte index into the entry layout text **/ gint gtk_entry_text_index_to_layout_index (GtkEntry *entry, gint text_index) { PangoLayout *layout; const gchar *text; gint cursor_index; g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, entry->current_pos) - text; if (text_index > cursor_index) text_index += entry->preedit_length; return text_index; } /** * gtk_entry_get_layout_offsets: * @entry: a #GtkEntry * @x: location to store X offset of layout, or %NULL * @y: location to store Y offset of layout, or %NULL * * * Obtains the position of the #PangoLayout used to render text * in the entry, in widget coordinates. Useful if you want to line * up the text in an entry with some other text, e.g. when using the * entry to implement editable cells in a sheet widget. * * Also useful to convert mouse events into coordinates inside the * #PangoLayout, e.g. to take some action if some part of the entry text * is clicked. * * Note that as the user scrolls around in the entry the offsets will * change; you'll need to connect to the "notify::scroll-offset" * signal to track this. Remember when using the #PangoLayout * functions you need to convert to and from pixels using * PANGO_PIXELS() or #PANGO_SCALE. * * Keep in mind that the layout text may contain a preedit string, so * gtk_entry_layout_index_to_text_index() and * gtk_entry_text_index_to_layout_index() are needed to convert byte * indices in the layout to byte indices in the entry contents. **/ void gtk_entry_get_layout_offsets (GtkEntry *entry, gint *x, gint *y) { gint text_area_x, text_area_y; g_return_if_fail (GTK_IS_ENTRY (entry)); /* this gets coords relative to text area */ get_layout_position (entry, x, y); /* convert to widget coords */ get_text_area_size (entry, &text_area_x, &text_area_y, NULL, NULL); if (x) *x += text_area_x; if (y) *y += text_area_y; } /** * gtk_entry_set_alignment: * @entry: a #GtkEntry * @xalign: The horizontal alignment, from 0 (left) to 1 (right). * Reversed for RTL layouts * * Sets the alignment for the contents of the entry. This controls * the horizontal positioning of the contents when the displayed * text is shorter than the width of the entry. * * Since: 2.4 **/ void gtk_entry_set_alignment (GtkEntry *entry, gfloat xalign) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = GTK_ENTRY_GET_PRIVATE (entry); if (xalign < 0.0) xalign = 0.0; else if (xalign > 1.0) xalign = 1.0; if (xalign != priv->xalign) { priv->xalign = xalign; gtk_entry_recompute (entry); g_object_notify (G_OBJECT (entry), "xalign"); } } /** * gtk_entry_get_alignment: * @entry: a #GtkEntry * * Gets the value set by gtk_entry_set_alignment(). * * Return value: the alignment * * Since: 2.4 **/ gfloat gtk_entry_get_alignment (GtkEntry *entry) { GtkEntryPrivate *priv; g_return_val_if_fail (GTK_IS_ENTRY (entry), 0.0); priv = GTK_ENTRY_GET_PRIVATE (entry); return priv->xalign; } /* Quick hack of a popup menu */ static void activate_cb (GtkWidget *menuitem, GtkEntry *entry) { const gchar *signal = g_object_get_data (G_OBJECT (menuitem), "gtk-signal"); g_signal_emit_by_name (entry, signal); } static gboolean gtk_entry_mnemonic_activate (GtkWidget *widget, gboolean group_cycling) { gtk_widget_grab_focus (widget); return TRUE; } static void append_action_signal (GtkEntry *entry, 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), entry); gtk_widget_set_sensitive (menuitem, sensitive); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem); } static void popup_menu_detach (GtkWidget *attach_widget, GtkMenu *menu) { GTK_ENTRY (attach_widget)->popup_menu = NULL; } static void popup_position_func (GtkMenu *menu, gint *x, gint *y, gboolean *push_in, gpointer user_data) { GtkEntry *entry = GTK_ENTRY (user_data); GtkWidget *widget = GTK_WIDGET (entry); GdkScreen *screen; GtkRequisition menu_req; GdkRectangle monitor; GtkBorder inner_border; gint monitor_num, strong_x, height; g_return_if_fail (GTK_WIDGET_REALIZED (entry)); gdk_window_get_origin (entry->text_area, x, y); screen = gtk_widget_get_screen (widget); monitor_num = gdk_screen_get_monitor_at_window (screen, entry->text_area); if (monitor_num < 0) monitor_num = 0; gtk_menu_set_monitor (menu, monitor_num); gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor); gtk_widget_size_request (entry->popup_menu, &menu_req); gdk_drawable_get_size (entry->text_area, NULL, &height); gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &strong_x, NULL); _gtk_entry_effective_inner_border (entry, &inner_border); *x += inner_border.left + strong_x - entry->scroll_offset; if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL) *x -= menu_req.width; if ((*y + height + menu_req.height) <= monitor.y + monitor.height) *y += height; else if ((*y - menu_req.height) >= monitor.y) *y -= menu_req.height; else if (monitor.y + monitor.height - (*y + height) > *y) *y += height; else *y -= menu_req.height; *push_in = FALSE; } static void unichar_chosen_func (const char *text, gpointer data) { GtkEntry *entry = GTK_ENTRY (data); if (entry->editable) gtk_entry_enter_text (entry, text); } typedef struct { GtkEntry *entry; gint button; guint time; } PopupInfo; static void popup_targets_received (GtkClipboard *clipboard, GtkSelectionData *data, gpointer user_data) { PopupInfo *info = user_data; GtkEntry *entry = info->entry; if (GTK_WIDGET_REALIZED (entry)) { gboolean clipboard_contains_text; GtkWidget *menuitem; GtkWidget *submenu; gboolean show_input_method_menu; gboolean show_unicode_menu; clipboard_contains_text = gtk_selection_data_targets_include_text (data); if (entry->popup_menu) gtk_widget_destroy (entry->popup_menu); entry->popup_menu = gtk_menu_new (); gtk_menu_attach_to_widget (GTK_MENU (entry->popup_menu), GTK_WIDGET (entry), popup_menu_detach); append_action_signal (entry, entry->popup_menu, GTK_STOCK_CUT, "cut_clipboard", entry->editable && entry->current_pos != entry->selection_bound); append_action_signal (entry, entry->popup_menu, GTK_STOCK_COPY, "copy_clipboard", entry->current_pos != entry->selection_bound); append_action_signal (entry, entry->popup_menu, GTK_STOCK_PASTE, "paste_clipboard", entry->editable && clipboard_contains_text); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_DELETE, NULL); gtk_widget_set_sensitive (menuitem, entry->editable && entry->current_pos != entry->selection_bound); g_signal_connect_swapped (menuitem, "activate", G_CALLBACK (gtk_entry_delete_cb), entry); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (entry->popup_menu), menuitem); menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (entry->popup_menu), menuitem); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_SELECT_ALL, NULL); g_signal_connect_swapped (menuitem, "activate", G_CALLBACK (gtk_entry_select_all), entry); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (entry->popup_menu), menuitem); g_object_get (gtk_widget_get_settings (GTK_WIDGET (entry)), "gtk-show-input-method-menu", &show_input_method_menu, "gtk-show-unicode-menu", &show_unicode_menu, NULL); if (!entry->visible) show_input_method_menu = FALSE; 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 (entry->popup_menu), menuitem); } if (show_input_method_menu) { menuitem = gtk_menu_item_new_with_mnemonic (_("Input _Methods")); gtk_widget_set_sensitive (menuitem, entry->editable); gtk_widget_show (menuitem); submenu = gtk_menu_new (); gtk_menu_item_set_submenu (GTK_MENU_ITEM (menuitem), submenu); gtk_menu_shell_append (GTK_MENU_SHELL (entry->popup_menu), menuitem); gtk_im_multicontext_append_menuitems (GTK_IM_MULTICONTEXT (entry->im_context), GTK_MENU_SHELL (submenu)); } if (show_unicode_menu) { menuitem = gtk_menu_item_new_with_mnemonic (_("_Insert Unicode Control Character")); gtk_widget_set_sensitive (menuitem, entry->editable); gtk_widget_show (menuitem); submenu = gtk_menu_new (); gtk_menu_item_set_submenu (GTK_MENU_ITEM (menuitem), submenu); gtk_menu_shell_append (GTK_MENU_SHELL (entry->popup_menu), menuitem); _gtk_text_util_append_special_char_menuitems (GTK_MENU_SHELL (submenu), unichar_chosen_func, entry); } g_signal_emit (entry, signals[POPULATE_POPUP], 0, entry->popup_menu); if (info->button) gtk_menu_popup (GTK_MENU (entry->popup_menu), NULL, NULL, NULL, NULL, info->button, info->time); else { gtk_menu_popup (GTK_MENU (entry->popup_menu), NULL, NULL, popup_position_func, entry, info->button, info->time); gtk_menu_shell_select_first (GTK_MENU_SHELL (entry->popup_menu), FALSE); } } g_object_unref (entry); g_slice_free (PopupInfo, info); } static void gtk_entry_do_popup (GtkEntry *entry, GdkEventButton *event) { PopupInfo *info = g_slice_new (PopupInfo); /* 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->entry = g_object_ref (entry); 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 (entry), GDK_SELECTION_CLIPBOARD), gdk_atom_intern_static_string ("TARGETS"), popup_targets_received, info); } static gboolean gtk_entry_popup_menu (GtkWidget *widget) { gtk_entry_do_popup (GTK_ENTRY (widget), NULL); return TRUE; } static void gtk_entry_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time) { GtkEntry *entry = GTK_ENTRY (widget); entry->dnd_position = -1; gtk_widget_queue_draw (widget); } static gboolean gtk_entry_drag_drop (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time) { GtkEntry *entry = GTK_ENTRY (widget); GdkAtom target = GDK_NONE; if (entry->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 gboolean gtk_entry_drag_motion (GtkWidget *widget, GdkDragContext *context, gint x, gint y, guint time) { GtkEntry *entry = GTK_ENTRY (widget); GtkWidget *source_widget; GdkDragAction suggested_action; gint new_position, old_position; gint sel1, sel2; x -= widget->style->xthickness; y -= widget->style->ythickness; old_position = entry->dnd_position; new_position = gtk_entry_find_position (entry, x + entry->scroll_offset); if (entry->editable && gtk_drag_dest_find_target (widget, context, NULL) != GDK_NONE) { source_widget = gtk_drag_get_source_widget (context); suggested_action = context->suggested_action; if (!gtk_editable_get_selection_bounds (GTK_EDITABLE (entry), &sel1, &sel2) || new_position < sel1 || new_position > sel2) { if (source_widget == widget) { /* Default to MOVE, unless the user has * pressed ctrl or alt to affect available actions */ if ((context->actions & GDK_ACTION_MOVE) != 0) suggested_action = GDK_ACTION_MOVE; } entry->dnd_position = new_position; } else { if (source_widget == widget) suggested_action = 0; /* Can't drop in selection where drag started */ entry->dnd_position = -1; } } else { /* Entry not editable, or no text */ suggested_action = 0; entry->dnd_position = -1; } gdk_drag_status (context, suggested_action, time); if (entry->dnd_position != old_position) gtk_widget_queue_draw (widget); return TRUE; } static void gtk_entry_drag_data_received (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time) { GtkEntry *entry = GTK_ENTRY (widget); GtkEditable *editable = GTK_EDITABLE (widget); gchar *str; str = (gchar *) gtk_selection_data_get_text (selection_data); x -= widget->style->xthickness; y -= widget->style->ythickness; if (str && entry->editable) { gint new_position; gint sel1, sel2; gint length = -1; if (entry->truncate_multiline) length = truncate_multiline (str); new_position = gtk_entry_find_position (entry, x + entry->scroll_offset); if (!gtk_editable_get_selection_bounds (editable, &sel1, &sel2) || new_position < sel1 || new_position > sel2) { gtk_editable_insert_text (editable, str, length, &new_position); } else { /* Replacing selection */ begin_change (entry); g_object_freeze_notify (G_OBJECT (entry)); gtk_editable_delete_text (editable, sel1, sel2); gtk_editable_insert_text (editable, str, length, &sel1); g_object_thaw_notify (G_OBJECT (entry)); end_change (entry); } gtk_drag_finish (context, TRUE, context->action == GDK_ACTION_MOVE, time); } else { /* Drag and drop didn't happen! */ gtk_drag_finish (context, FALSE, FALSE, time); } g_free (str); } static void gtk_entry_drag_data_get (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time) { gint sel_start, sel_end; GtkEditable *editable = GTK_EDITABLE (widget); if (gtk_editable_get_selection_bounds (editable, &sel_start, &sel_end)) { gchar *str = gtk_entry_get_public_chars (GTK_ENTRY (widget), sel_start, sel_end); gtk_selection_data_set_text (selection_data, str, -1); g_free (str); } } static void gtk_entry_drag_data_delete (GtkWidget *widget, GdkDragContext *context) { gint sel_start, sel_end; GtkEditable *editable = GTK_EDITABLE (widget); if (GTK_ENTRY (widget)->editable && gtk_editable_get_selection_bounds (editable, &sel_start, &sel_end)) gtk_editable_delete_text (editable, sel_start, sel_end); } /* We display the cursor when * * - the selection is empty, AND * - the widget has focus */ #define CURSOR_ON_MULTIPLIER 2 #define CURSOR_OFF_MULTIPLIER 1 #define CURSOR_PEND_MULTIPLIER 3 #define CURSOR_DIVIDER 3 static gboolean cursor_blinks (GtkEntry *entry) { if (GTK_WIDGET_HAS_FOCUS (entry) && entry->editable && entry->selection_bound == entry->current_pos) { GtkSettings *settings; gboolean blink; settings = gtk_widget_get_settings (GTK_WIDGET (entry)); g_object_get (settings, "gtk-cursor-blink", &blink, NULL); return blink; } else return FALSE; } static gint get_cursor_time (GtkEntry *entry) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (entry)); gint time; g_object_get (settings, "gtk-cursor-blink-time", &time, NULL); return time; } static gint get_cursor_blink_timeout (GtkEntry *entry) { GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (entry)); gint timeout; g_object_get (settings, "gtk-cursor-blink-timeout", &timeout, NULL); return timeout; } static void show_cursor (GtkEntry *entry) { if (!entry->cursor_visible) { entry->cursor_visible = TRUE; if (GTK_WIDGET_HAS_FOCUS (entry) && entry->selection_bound == entry->current_pos) gtk_widget_queue_draw (GTK_WIDGET (entry)); } } static void hide_cursor (GtkEntry *entry) { if (entry->cursor_visible) { entry->cursor_visible = FALSE; if (GTK_WIDGET_HAS_FOCUS (entry) && entry->selection_bound == entry->current_pos) gtk_widget_queue_draw (GTK_WIDGET (entry)); } } /* * Blink! */ static gint blink_cb (gpointer data) { GtkEntry *entry; GtkEntryPrivate *priv; gint blink_timeout; entry = GTK_ENTRY (data); priv = GTK_ENTRY_GET_PRIVATE (entry); if (!GTK_WIDGET_HAS_FOCUS (entry)) { g_warning ("GtkEntry - did not receive focus-out-event. If you\n" "connect a handler to this signal, it must return\n" "FALSE so the entry gets the event as well"); gtk_entry_check_cursor_blink (entry); return FALSE; } g_assert (entry->selection_bound == entry->current_pos); blink_timeout = get_cursor_blink_timeout (entry); if (priv->blink_time > 1000 * blink_timeout && blink_timeout < G_MAXINT/1000) { /* we've blinked enough without the user doing anything, stop blinking */ show_cursor (entry); entry->blink_timeout = 0; } else if (entry->cursor_visible) { hide_cursor (entry); entry->blink_timeout = gdk_threads_add_timeout (get_cursor_time (entry) * CURSOR_OFF_MULTIPLIER / CURSOR_DIVIDER, blink_cb, entry); } else { show_cursor (entry); priv->blink_time += get_cursor_time (entry); entry->blink_timeout = gdk_threads_add_timeout (get_cursor_time (entry) * CURSOR_ON_MULTIPLIER / CURSOR_DIVIDER, blink_cb, entry); } /* Remove ourselves */ return FALSE; } static void gtk_entry_check_cursor_blink (GtkEntry *entry) { GtkEntryPrivate *priv; priv = GTK_ENTRY_GET_PRIVATE (entry); if (cursor_blinks (entry)) { if (!entry->blink_timeout) { show_cursor (entry); entry->blink_timeout = gdk_threads_add_timeout (get_cursor_time (entry) * CURSOR_ON_MULTIPLIER / CURSOR_DIVIDER, blink_cb, entry); } } else { if (entry->blink_timeout) { g_source_remove (entry->blink_timeout); entry->blink_timeout = 0; } entry->cursor_visible = TRUE; } } static void gtk_entry_pend_cursor_blink (GtkEntry *entry) { if (cursor_blinks (entry)) { if (entry->blink_timeout != 0) g_source_remove (entry->blink_timeout); entry->blink_timeout = gdk_threads_add_timeout (get_cursor_time (entry) * CURSOR_PEND_MULTIPLIER / CURSOR_DIVIDER, blink_cb, entry); show_cursor (entry); } } static void gtk_entry_reset_blink_time (GtkEntry *entry) { GtkEntryPrivate *priv; priv = GTK_ENTRY_GET_PRIVATE (entry); priv->blink_time = 0; } /* completion */ static gint gtk_entry_completion_timeout (gpointer data) { GtkEntryCompletion *completion = GTK_ENTRY_COMPLETION (data); completion->priv->completion_timeout = 0; if (completion->priv->filter_model && g_utf8_strlen (gtk_entry_get_text (GTK_ENTRY (completion->priv->entry)), -1) >= completion->priv->minimum_key_length) { gint matches; gint actions; GtkTreeSelection *s; gboolean popup_single; gtk_entry_completion_complete (completion); matches = gtk_tree_model_iter_n_children (GTK_TREE_MODEL (completion->priv->filter_model), NULL); gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->tree_view))); s = gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->action_view)); gtk_tree_selection_unselect_all (s); actions = gtk_tree_model_iter_n_children (GTK_TREE_MODEL (completion->priv->actions), NULL); g_object_get (completion, "popup-single-match", &popup_single, NULL); if ((matches > (popup_single ? 0: 1)) || actions > 0) { if (GTK_WIDGET_VISIBLE (completion->priv->popup_window)) _gtk_entry_completion_resize_popup (completion); else _gtk_entry_completion_popup (completion); } else _gtk_entry_completion_popdown (completion); } else if (GTK_WIDGET_VISIBLE (completion->priv->popup_window)) _gtk_entry_completion_popdown (completion); return FALSE; } static inline gboolean keyval_is_cursor_move (guint keyval) { if (keyval == GDK_Up || keyval == GDK_KP_Up) return TRUE; if (keyval == GDK_Down || keyval == GDK_KP_Down) return TRUE; if (keyval == GDK_Page_Up) return TRUE; if (keyval == GDK_Page_Down) return TRUE; return FALSE; } static gboolean gtk_entry_completion_key_press (GtkWidget *widget, GdkEventKey *event, gpointer user_data) { gint matches, actions = 0; GtkEntryCompletion *completion = GTK_ENTRY_COMPLETION (user_data); if (!GTK_WIDGET_MAPPED (completion->priv->popup_window)) return FALSE; matches = gtk_tree_model_iter_n_children (GTK_TREE_MODEL (completion->priv->filter_model), NULL); if (completion->priv->actions) actions = gtk_tree_model_iter_n_children (GTK_TREE_MODEL (completion->priv->actions), NULL); if (keyval_is_cursor_move (event->keyval)) { GtkTreePath *path = NULL; if (event->keyval == GDK_Up || event->keyval == GDK_KP_Up) { if (completion->priv->current_selected < 0) completion->priv->current_selected = matches + actions - 1; else completion->priv->current_selected--; } else if (event->keyval == GDK_Down || event->keyval == GDK_KP_Down) { if (completion->priv->current_selected < matches + actions - 1) completion->priv->current_selected++; else completion->priv->current_selected = -1; } else if (event->keyval == GDK_Page_Up) { if (completion->priv->current_selected < 0) completion->priv->current_selected = matches + actions - 1; else if (completion->priv->current_selected == 0) completion->priv->current_selected = -1; else if (completion->priv->current_selected < matches) { completion->priv->current_selected -= 14; if (completion->priv->current_selected < 0) completion->priv->current_selected = 0; } else { completion->priv->current_selected -= 14; if (completion->priv->current_selected < matches - 1) completion->priv->current_selected = matches - 1; } } else if (event->keyval == GDK_Page_Down) { if (completion->priv->current_selected < 0) completion->priv->current_selected = 0; else if (completion->priv->current_selected < matches - 1) { completion->priv->current_selected += 14; if (completion->priv->current_selected > matches - 1) completion->priv->current_selected = matches - 1; } else if (completion->priv->current_selected == matches + actions - 1) { completion->priv->current_selected = -1; } else { completion->priv->current_selected += 14; if (completion->priv->current_selected > matches + actions - 1) completion->priv->current_selected = matches + actions - 1; } } if (completion->priv->current_selected < 0) { gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->tree_view))); gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->action_view))); if (completion->priv->inline_selection && completion->priv->completion_prefix) { gtk_entry_set_text (GTK_ENTRY (completion->priv->entry), completion->priv->completion_prefix); gtk_editable_set_position (GTK_EDITABLE (widget), -1); } } else if (completion->priv->current_selected < matches) { gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->action_view))); path = gtk_tree_path_new_from_indices (completion->priv->current_selected, -1); gtk_tree_view_set_cursor (GTK_TREE_VIEW (completion->priv->tree_view), path, NULL, FALSE); if (completion->priv->inline_selection) { GtkTreeIter iter; GtkTreeModel *model = NULL; GtkTreeSelection *sel; gboolean entry_set; sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->tree_view)); if (!gtk_tree_selection_get_selected (sel, &model, &iter)) return FALSE; if (completion->priv->completion_prefix == NULL) completion->priv->completion_prefix = g_strdup (gtk_entry_get_text (GTK_ENTRY (completion->priv->entry))); g_signal_emit_by_name (completion, "cursor_on_match", model, &iter, &entry_set); } } else if (completion->priv->current_selected - matches >= 0) { gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->tree_view))); path = gtk_tree_path_new_from_indices (completion->priv->current_selected - matches, -1); gtk_tree_view_set_cursor (GTK_TREE_VIEW (completion->priv->action_view), path, NULL, FALSE); if (completion->priv->inline_selection && completion->priv->completion_prefix) { gtk_entry_set_text (GTK_ENTRY (completion->priv->entry), completion->priv->completion_prefix); gtk_editable_set_position (GTK_EDITABLE (widget), -1); } } gtk_tree_path_free (path); return TRUE; } else if (event->keyval == GDK_Escape || event->keyval == GDK_Left || event->keyval == GDK_KP_Left || event->keyval == GDK_Right || event->keyval == GDK_KP_Right) { gboolean retval = TRUE; _gtk_entry_reset_im_context (GTK_ENTRY (widget)); _gtk_entry_completion_popdown (completion); if (completion->priv->current_selected < 0) { retval = FALSE; goto keypress_completion_out; } else if (completion->priv->inline_selection) { /* Escape rejects the tentative completion */ if (event->keyval == GDK_Escape) { if (completion->priv->completion_prefix) gtk_entry_set_text (GTK_ENTRY (completion->priv->entry), completion->priv->completion_prefix); else gtk_entry_set_text (GTK_ENTRY (completion->priv->entry), ""); } /* Move the cursor to the end for Right/Esc, to the beginning for Left */ if (event->keyval == GDK_Right || event->keyval == GDK_KP_Right || event->keyval == GDK_Escape) gtk_editable_set_position (GTK_EDITABLE (widget), -1); else gtk_editable_set_position (GTK_EDITABLE (widget), 0); } keypress_completion_out: if (completion->priv->inline_selection) { g_free (completion->priv->completion_prefix); completion->priv->completion_prefix = NULL; } return retval; } else if (event->keyval == GDK_Tab || event->keyval == GDK_KP_Tab || event->keyval == GDK_ISO_Left_Tab) { GtkDirectionType dir = event->keyval == GDK_ISO_Left_Tab ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD; _gtk_entry_reset_im_context (GTK_ENTRY (widget)); _gtk_entry_completion_popdown (completion); g_free (completion->priv->completion_prefix); completion->priv->completion_prefix = NULL; gtk_widget_child_focus (gtk_widget_get_toplevel (widget), dir); return TRUE; } else if (event->keyval == GDK_ISO_Enter || event->keyval == GDK_KP_Enter || event->keyval == GDK_Return) { gboolean retval = TRUE; _gtk_entry_reset_im_context (GTK_ENTRY (widget)); _gtk_entry_completion_popdown (completion); if (completion->priv->current_selected < matches) { GtkTreeIter iter; GtkTreeModel *model = NULL; GtkTreeSelection *sel; gboolean entry_set; sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->tree_view)); if (gtk_tree_selection_get_selected (sel, &model, &iter)) { g_signal_handler_block (widget, completion->priv->changed_id); g_signal_emit_by_name (completion, "match_selected", model, &iter, &entry_set); g_signal_handler_unblock (widget, completion->priv->changed_id); if (!entry_set) { gchar *str = NULL; gtk_tree_model_get (model, &iter, completion->priv->text_column, &str, -1); gtk_entry_set_text (GTK_ENTRY (widget), str); /* move the cursor to the end */ gtk_editable_set_position (GTK_EDITABLE (widget), -1); g_free (str); } } else retval = FALSE; } else if (completion->priv->current_selected - matches >= 0) { GtkTreePath *path; _gtk_entry_reset_im_context (GTK_ENTRY (widget)); path = gtk_tree_path_new_from_indices (completion->priv->current_selected - matches, -1); g_signal_emit_by_name (completion, "action_activated", gtk_tree_path_get_indices (path)[0]); gtk_tree_path_free (path); } g_free (completion->priv->completion_prefix); completion->priv->completion_prefix = NULL; return retval; } return FALSE; } static void gtk_entry_completion_changed (GtkWidget *entry, gpointer user_data) { GtkEntryCompletion *completion = GTK_ENTRY_COMPLETION (user_data); /* (re)install completion timeout */ if (completion->priv->completion_timeout) g_source_remove (completion->priv->completion_timeout); if (!gtk_entry_get_text (GTK_ENTRY (entry))) return; /* no need to normalize for this test */ if (completion->priv->minimum_key_length > 0 && strcmp ("", gtk_entry_get_text (GTK_ENTRY (entry))) == 0) { if (GTK_WIDGET_VISIBLE (completion->priv->popup_window)) _gtk_entry_completion_popdown (completion); return; } completion->priv->completion_timeout = gdk_threads_add_timeout (COMPLETION_TIMEOUT, gtk_entry_completion_timeout, completion); } static gboolean check_completion_callback (GtkEntryCompletion *completion) { completion->priv->check_completion_idle = NULL; gtk_entry_completion_complete (completion); gtk_entry_completion_insert_prefix (completion); return FALSE; } static void clear_completion_callback (GtkEntry *entry, GParamSpec *pspec) { if (pspec->name == I_("cursor-position") || pspec->name == I_("selection-bound")) { GtkEntryCompletion *completion = gtk_entry_get_completion (entry); completion->priv->has_completion = FALSE; } } static gboolean accept_completion_callback (GtkEntry *entry) { GtkEntryCompletion *completion = gtk_entry_get_completion (entry); if (completion->priv->has_completion) gtk_editable_set_position (GTK_EDITABLE (entry), entry->text_length); return FALSE; } static void completion_insert_text_callback (GtkEntry *entry, const gchar *text, gint length, gint position, GtkEntryCompletion *completion) { /* idle to update the selection based on the file list */ if (completion->priv->check_completion_idle == NULL) { completion->priv->check_completion_idle = g_idle_source_new (); g_source_set_priority (completion->priv->check_completion_idle, G_PRIORITY_HIGH); g_source_set_closure (completion->priv->check_completion_idle, g_cclosure_new_object (G_CALLBACK (check_completion_callback), G_OBJECT (completion))); g_source_attach (completion->priv->check_completion_idle, NULL); } } static void completion_changed (GtkEntryCompletion *completion, GParamSpec *pspec, gpointer data) { GtkEntry *entry = GTK_ENTRY (data); if (pspec->name == I_("popup-completion") || pspec->name == I_("inline-completion")) { disconnect_completion_signals (entry, completion); connect_completion_signals (entry, completion); } } static void disconnect_completion_signals (GtkEntry *entry, GtkEntryCompletion *completion) { g_signal_handlers_disconnect_by_func (completion, G_CALLBACK (completion_changed), entry); if (completion->priv->changed_id > 0 && g_signal_handler_is_connected (entry, completion->priv->changed_id)) { g_signal_handler_disconnect (entry, completion->priv->changed_id); completion->priv->changed_id = 0; } g_signal_handlers_disconnect_by_func (entry, G_CALLBACK (gtk_entry_completion_key_press), completion); if (completion->priv->insert_text_id > 0 && g_signal_handler_is_connected (entry, completion->priv->insert_text_id)) { g_signal_handler_disconnect (entry, completion->priv->insert_text_id); completion->priv->insert_text_id = 0; } g_signal_handlers_disconnect_by_func (entry, G_CALLBACK (completion_insert_text_callback), completion); g_signal_handlers_disconnect_by_func (entry, G_CALLBACK (clear_completion_callback), completion); g_signal_handlers_disconnect_by_func (entry, G_CALLBACK (accept_completion_callback), completion); } static void connect_completion_signals (GtkEntry *entry, GtkEntryCompletion *completion) { if (completion->priv->popup_completion) { completion->priv->changed_id = g_signal_connect (entry, "changed", G_CALLBACK (gtk_entry_completion_changed), completion); g_signal_connect (entry, "key_press_event", G_CALLBACK (gtk_entry_completion_key_press), completion); } if (completion->priv->inline_completion) { completion->priv->insert_text_id = g_signal_connect (entry, "insert_text", G_CALLBACK (completion_insert_text_callback), completion); g_signal_connect (entry, "notify", G_CALLBACK (clear_completion_callback), completion); g_signal_connect (entry, "activate", G_CALLBACK (accept_completion_callback), completion); g_signal_connect (entry, "focus_out_event", G_CALLBACK (accept_completion_callback), completion); } g_signal_connect (completion, "notify", G_CALLBACK (completion_changed), entry); } /** * gtk_entry_set_completion: * @entry: A #GtkEntry * @completion: The #GtkEntryCompletion or %NULL * * Sets @completion to be the auxiliary completion object to use with @entry. * All further configuration of the completion mechanism is done on * @completion using the #GtkEntryCompletion API. Completion is disabled if * @completion is set to %NULL. * * Since: 2.4 */ void gtk_entry_set_completion (GtkEntry *entry, GtkEntryCompletion *completion) { GtkEntryCompletion *old; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (!completion || GTK_IS_ENTRY_COMPLETION (completion)); old = gtk_entry_get_completion (entry); if (old == completion) return; if (old) { if (old->priv->completion_timeout) { g_source_remove (old->priv->completion_timeout); old->priv->completion_timeout = 0; } if (GTK_WIDGET_MAPPED (old->priv->popup_window)) _gtk_entry_completion_popdown (old); disconnect_completion_signals (entry, old); old->priv->entry = NULL; g_object_unref (old); } if (!completion) { g_object_set_data (G_OBJECT (entry), I_(GTK_ENTRY_COMPLETION_KEY), NULL); return; } /* hook into the entry */ g_object_ref (completion); connect_completion_signals (entry, completion); completion->priv->entry = GTK_WIDGET (entry); g_object_set_data (G_OBJECT (entry), I_(GTK_ENTRY_COMPLETION_KEY), completion); } /** * gtk_entry_get_completion: * @entry: A #GtkEntry * * Returns the auxiliary completion object currently in use by @entry. * * Return value: The auxiliary completion object currently in use by @entry. * * Since: 2.4 */ GtkEntryCompletion * gtk_entry_get_completion (GtkEntry *entry) { GtkEntryCompletion *completion; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); completion = GTK_ENTRY_COMPLETION (g_object_get_data (G_OBJECT (entry), GTK_ENTRY_COMPLETION_KEY)); return completion; } /** * gtk_entry_set_cursor_hadjustment: * @entry: a #GtkEntry * @adjustment: an adjustment which should be adjusted when the cursor * is moved, or %NULL * * Hooks up an adjustment to the cursor position in an entry, so that when * the cursor is moved, the adjustment is scrolled to show that position. * See gtk_scrolled_window_get_hadjustment() for a typical way of obtaining * the adjustment. * * The adjustment has to be in pixel units and in the same coordinate system * as the entry. * * Since: 2.12 */ void gtk_entry_set_cursor_hadjustment (GtkEntry *entry, GtkAdjustment *adjustment) { g_return_if_fail (GTK_IS_ENTRY (entry)); if (adjustment) g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment)); if (adjustment) g_object_ref (adjustment); g_object_set_qdata_full (G_OBJECT (entry), quark_cursor_hadjustment, adjustment, g_object_unref); } /** * gtk_entry_get_cursor_hadjustment: * @entry: a #GtkEntry * * Retrieves the horizontal cursor adjustment for the entry. * See gtk_entry_set_cursor_hadjustment(). * * Return value: the horizontal cursor adjustment, or %NULL * if none has been set. * * Since: 2.12 */ GtkAdjustment* gtk_entry_get_cursor_hadjustment (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return g_object_get_qdata (G_OBJECT (entry), quark_cursor_hadjustment); } #define __GTK_ENTRY_C__ #include "gtkaliasdef.c"