/* -*- 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 * Copyright (C) 2004-2006 Christian Hammond * Copyright (C) 2008 Cody Russell * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "config.h" #include #include #include "gtkbindings.h" #include "gtkcelleditable.h" #include "gtkclipboard.h" #include "gtkdnd.h" #include "gtkentry.h" #include "gtkentrybuffer.h" #include "gtkiconhelperprivate.h" #include "gtkimagemenuitem.h" #include "gtkimcontextsimple.h" #include "gtkimmulticontext.h" #include "gtkintl.h" #include "gtklabel.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 "gtktypebuiltins.h" #include "gtkprivate.h" #include "gtkentryprivate.h" #include "gtkcelllayout.h" #include "gtktooltip.h" #include "gtkiconfactory.h" #include "gtkicontheme.h" #include "gtkwidgetprivate.h" #include "gtkstylecontextprivate.h" #include "a11y/gtkentryaccessible.h" /** * SECTION:gtkentry * @Short_description: A single line text entry field * @Title: GtkEntry * @See_also: #GtkTextView, #GtkEntryCompletion * * The #GtkEntry widget is a single line text entry * widget. A fairly large set of key bindings are supported * by default. If the entered text is longer than the allocation * of the widget, the widget will scroll so that the cursor * position is visible. * * When using an entry for passwords and other sensitive information, * it can be put into "password mode" using gtk_entry_set_visibility(). * In this mode, entered text is displayed using a 'invisible' character. * By default, GTK+ picks the best invisible character that is available * in the current font, but it can be changed with * gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning * when Caps Lock or input methods might interfere with entering text in * a password entry. The warning can be turned off with the * #GtkEntry:caps-lock-warning property. * * Since 2.16, GtkEntry has the ability to display progress or activity * information behind the text. To make an entry display such information, * use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step(). * * Additionally, GtkEntry can show icons at either side of the entry. These * icons can be activatable by clicking, can be set up as drag source and * can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon() or * one of the various other functions that set an icon from a stock id, an * icon name or a pixbuf. To trigger an action when the user clicks an icon, * connect to the #GtkEntry::icon-press signal. To allow DND operations * from an icon, use gtk_entry_set_icon_drag_source(). To set a tooltip on * an icon, use gtk_entry_set_icon_tooltip_text() or the corresponding function * for markup. * * Note that functionality or information that is only available by clicking * on an icon in an entry may not be accessible at all to users which are not * able to use a mouse or other pointing device. It is therefore recommended * that any such functionality should also be available by other means, e.g. * via the context menu of the entry. */ #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 #define PAGE_STEP 14 #define MAX_ICONS 2 #define IS_VALID_ICON_POSITION(pos) \ ((pos) == GTK_ENTRY_ICON_PRIMARY || \ (pos) == GTK_ENTRY_ICON_SECONDARY) 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; static GQuark quark_capslock_feedback = 0; typedef struct _EntryIconInfo EntryIconInfo; typedef struct _GtkEntryPasswordHint GtkEntryPasswordHint; typedef struct _GtkEntryCapslockFeedback GtkEntryCapslockFeedback; struct _GtkEntryPrivate { EntryIconInfo *icons[MAX_ICONS]; GtkEntryBuffer *buffer; GtkIMContext *im_context; GtkShadowType shadow_type; GtkWidget *popup_menu; GdkDevice *completion_device; GdkWindow *text_area; PangoLayout *cached_layout; gchar *im_module; gdouble progress_fraction; gdouble progress_pulse_fraction; gdouble progress_pulse_current; gchar *placeholder_text; gfloat xalign; gint ascent; /* font ascent in pango units */ gint current_pos; gint descent; /* font descent in pango units */ gint dnd_position; /* In chars, -1 == no DND cursor */ gint drag_start_x; gint drag_start_y; gint focus_width; gint insert_pos; gint selection_bound; gint scroll_offset; gint start_x; gint start_y; gint width_chars; gunichar invisible_char; guint button; guint blink_time; /* time in msec the cursor has blinked since last user event */ guint blink_timeout; guint recompute_idle; guint16 x_text_size; /* allocated size, in bytes */ guint16 x_n_bytes; /* length in use, in bytes */ guint16 preedit_length; /* length of preedit string, in bytes */ guint16 preedit_cursor; /* offset of cursor within preedit string, in chars */ guint editable : 1; guint in_drag : 1; guint overwrite_mode : 1; guint visible : 1; guint activates_default : 1; guint cache_includes_preedit : 1; guint caps_lock_warning : 1; guint caps_lock_warning_shown : 1; guint change_count : 8; guint cursor_visible : 1; guint editing_canceled : 1; /* Only used by GtkCellRendererText */ guint has_frame : 1; guint in_click : 1; /* Flag so we don't select all when clicking in entry to focus in */ guint is_cell_renderer : 1; guint invisible_char_set : 1; guint interior_focus : 1; guint mouse_cursor_obscured : 1; guint need_im_reset : 1; guint progress_pulse_mode : 1; guint progress_pulse_way_back : 1; guint real_changed : 1; guint resolved_dir : 4; /* PangoDirection */ guint select_words : 1; guint select_lines : 1; guint truncate_multiline : 1; }; struct _EntryIconInfo { GdkWindow *window; gchar *tooltip; guint insensitive : 1; guint nonactivatable : 1; guint prelight : 1; guint in_drag : 1; guint pressed : 1; GtkIconHelper *icon_helper; GtkTargetList *target_list; GdkDragAction actions; }; struct _GtkEntryPasswordHint { gint position; /* Position (in text) of the last password hint */ guint source_id; /* Timeout source id */ }; struct _GtkEntryCapslockFeedback { GtkWidget *entry; GtkWidget *window; GtkWidget *label; }; enum { ACTIVATE, POPULATE_POPUP, MOVE_CURSOR, INSERT_AT_CURSOR, DELETE_FROM_CURSOR, BACKSPACE, CUT_CLIPBOARD, COPY_CLIPBOARD, PASTE_CLIPBOARD, TOGGLE_OVERWRITE, ICON_PRESS, ICON_RELEASE, PREEDIT_CHANGED, LAST_SIGNAL }; enum { PROP_0, PROP_BUFFER, 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, PROP_INVISIBLE_CHAR_SET, PROP_CAPS_LOCK_WARNING, PROP_PROGRESS_FRACTION, PROP_PROGRESS_PULSE_STEP, PROP_PIXBUF_PRIMARY, PROP_PIXBUF_SECONDARY, PROP_STOCK_PRIMARY, PROP_STOCK_SECONDARY, PROP_ICON_NAME_PRIMARY, PROP_ICON_NAME_SECONDARY, PROP_GICON_PRIMARY, PROP_GICON_SECONDARY, PROP_STORAGE_TYPE_PRIMARY, PROP_STORAGE_TYPE_SECONDARY, PROP_ACTIVATABLE_PRIMARY, PROP_ACTIVATABLE_SECONDARY, PROP_SENSITIVE_PRIMARY, PROP_SENSITIVE_SECONDARY, PROP_TOOLTIP_TEXT_PRIMARY, PROP_TOOLTIP_TEXT_SECONDARY, PROP_TOOLTIP_MARKUP_PRIMARY, PROP_TOOLTIP_MARKUP_SECONDARY, PROP_IM_MODULE, PROP_EDITING_CANCELED, PROP_PLACEHOLDER_TEXT, PROP_COMPLETION }; static guint signals[LAST_SIGNAL] = { 0 }; typedef enum { CURSOR_STANDARD, CURSOR_DND } CursorType; typedef enum { DISPLAY_NORMAL, /* The entry text is being shown */ DISPLAY_INVISIBLE, /* In invisible mode, text replaced by (eg) bullets */ DISPLAY_BLANK /* In invisible mode, nothing shown at all */ } DisplayMode; /* GObject methods */ static void gtk_entry_editable_init (GtkEditableInterface *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_dispose (GObject *object); /* GtkWidget methods */ static void gtk_entry_destroy (GtkWidget *widget); static void gtk_entry_realize (GtkWidget *widget); static void gtk_entry_unrealize (GtkWidget *widget); static void gtk_entry_map (GtkWidget *widget); static void gtk_entry_unmap (GtkWidget *widget); static void gtk_entry_get_preferred_width (GtkWidget *widget, gint *minimum, gint *natural); static void gtk_entry_get_preferred_height (GtkWidget *widget, gint *minimum, gint *natural); static void gtk_entry_size_allocate (GtkWidget *widget, GtkAllocation *allocation); static void gtk_entry_draw_frame (GtkWidget *widget, GtkStyleContext *context, cairo_t *cr); static void gtk_entry_draw_progress (GtkWidget *widget, GtkStyleContext *context, cairo_t *cr); static gint gtk_entry_draw (GtkWidget *widget, cairo_t *cr); static gint gtk_entry_button_press (GtkWidget *widget, GdkEventButton *event); static gint gtk_entry_button_release (GtkWidget *widget, GdkEventButton *event); static gint gtk_entry_enter_notify (GtkWidget *widget, GdkEventCrossing *event); static gint gtk_entry_leave_notify (GtkWidget *widget, GdkEventCrossing *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_updated (GtkWidget *widget); static gboolean gtk_entry_query_tooltip (GtkWidget *widget, gint x, gint y, gboolean keyboard_tip, GtkTooltip *tooltip); static void gtk_entry_direction_changed (GtkWidget *widget, GtkTextDirection previous_dir); static void gtk_entry_state_flags_changed (GtkWidget *widget, GtkStateFlags 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); static void gtk_entry_drag_begin (GtkWidget *widget, GdkDragContext *context); static void gtk_entry_drag_end (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 keymap_direction_changed (GdkKeymap *keymap, GtkEntry *entry); static void keymap_state_changed (GdkKeymap *keymap, GtkEntry *entry); static void remove_capslock_feedback (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, cairo_t *cr); static void gtk_entry_draw_cursor (GtkEntry *entry, cairo_t *cr, 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_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 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_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 gtk_entry_get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height); static void get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height); static void get_frame_size (GtkEntry *entry, gboolean relative_to_window, gint *x, gint *y, gint *width, gint *height); static void gtk_entry_move_adjustments (GtkEntry *entry); static GdkPixbuf * gtk_entry_ensure_pixbuf (GtkEntry *entry, GtkEntryIconPosition icon_pos); static void gtk_entry_update_cached_style_values(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); static void buffer_inserted_text (GtkEntryBuffer *buffer, guint position, const gchar *chars, guint n_chars, GtkEntry *entry); static void buffer_deleted_text (GtkEntryBuffer *buffer, guint position, guint n_chars, GtkEntry *entry); static void buffer_notify_text (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry); static void buffer_notify_length (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry); static void buffer_notify_max_length (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry); static void buffer_connect_signals (GtkEntry *entry); static void buffer_disconnect_signals (GtkEntry *entry); static GtkEntryBuffer *get_buffer (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; GtkBindingSet *binding_set; widget_class = (GtkWidgetClass*) class; gobject_class->dispose = gtk_entry_dispose; gobject_class->finalize = gtk_entry_finalize; gobject_class->set_property = gtk_entry_set_property; gobject_class->get_property = gtk_entry_get_property; widget_class->destroy = gtk_entry_destroy; widget_class->map = gtk_entry_map; widget_class->unmap = gtk_entry_unmap; widget_class->realize = gtk_entry_realize; widget_class->unrealize = gtk_entry_unrealize; widget_class->get_preferred_width = gtk_entry_get_preferred_width; widget_class->get_preferred_height = gtk_entry_get_preferred_height; widget_class->size_allocate = gtk_entry_size_allocate; widget_class->draw = gtk_entry_draw; widget_class->enter_notify_event = gtk_entry_enter_notify; widget_class->leave_notify_event = gtk_entry_leave_notify; 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_updated = gtk_entry_style_updated; widget_class->query_tooltip = gtk_entry_query_tooltip; widget_class->drag_begin = gtk_entry_drag_begin; widget_class->drag_end = gtk_entry_drag_end; widget_class->direction_changed = gtk_entry_direction_changed; widget_class->state_flags_changed = gtk_entry_state_flags_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; 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"); quark_capslock_feedback = g_quark_from_static_string ("gtk-entry-capslock-feedback"); g_object_class_override_property (gobject_class, PROP_EDITING_CANCELED, "editing-canceled"); g_object_class_install_property (gobject_class, PROP_BUFFER, g_param_spec_object ("buffer", P_("Text Buffer"), P_("Text buffer object which actually stores entry text"), GTK_TYPE_ENTRY_BUFFER, GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT)); 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, GTK_ENTRY_BUFFER_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, GTK_ENTRY_BUFFER_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, GTK_ENTRY_BUFFER_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)); /** * GtkEntry:inner-border: * * Sets the text area's border between the text and the frame. * * Deprecated: 3.4: Use the standard border and padding CSS properties; * the value of this style property is ignored. */ 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_PARAM_DEPRECATED)); 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)); /** * GtkEntry:invisible-char-set: * * Whether the invisible char has been set for the #GtkEntry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_INVISIBLE_CHAR_SET, g_param_spec_boolean ("invisible-char-set", P_("Invisible character set"), P_("Whether the invisible character has been set"), FALSE, GTK_PARAM_READWRITE)); /** * GtkEntry:caps-lock-warning * * Whether password entries will show a warning when Caps Lock is on. * * Note that the warning is shown using a secondary icon, and thus * does not work if you are using the secondary icon position for some * other purpose. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_CAPS_LOCK_WARNING, g_param_spec_boolean ("caps-lock-warning", P_("Caps Lock warning"), P_("Whether password entries will show a warning when Caps Lock is on"), TRUE, GTK_PARAM_READWRITE)); /** * GtkEntry:progress-fraction: * * The current fraction of the task that's been completed. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_PROGRESS_FRACTION, g_param_spec_double ("progress-fraction", P_("Progress Fraction"), P_("The current fraction of the task that's been completed"), 0.0, 1.0, 0.0, GTK_PARAM_READWRITE)); /** * GtkEntry:progress-pulse-step: * * The fraction of total entry width to move the progress * bouncing block for each call to gtk_entry_progress_pulse(). * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_PROGRESS_PULSE_STEP, g_param_spec_double ("progress-pulse-step", P_("Progress Pulse Step"), P_("The fraction of total entry width to move the progress bouncing block for each call to gtk_entry_progress_pulse()"), 0.0, 1.0, 0.1, GTK_PARAM_READWRITE)); /** * GtkEntry:placeholder-text: * * The text that will be displayed in the #GtkEntry when it is empty * and unfocused. * * Since: 3.2 */ g_object_class_install_property (gobject_class, PROP_PLACEHOLDER_TEXT, g_param_spec_string ("placeholder-text", P_("Placeholder text"), P_("Show text in the entry when it's empty and unfocused"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-pixbuf: * * A pixbuf to use as the primary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_PIXBUF_PRIMARY, g_param_spec_object ("primary-icon-pixbuf", P_("Primary pixbuf"), P_("Primary pixbuf for the entry"), GDK_TYPE_PIXBUF, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-pixbuf: * * An pixbuf to use as the secondary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_PIXBUF_SECONDARY, g_param_spec_object ("secondary-icon-pixbuf", P_("Secondary pixbuf"), P_("Secondary pixbuf for the entry"), GDK_TYPE_PIXBUF, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-stock: * * The stock id to use for the primary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_STOCK_PRIMARY, g_param_spec_string ("primary-icon-stock", P_("Primary stock ID"), P_("Stock ID for primary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-stock: * * The stock id to use for the secondary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_STOCK_SECONDARY, g_param_spec_string ("secondary-icon-stock", P_("Secondary stock ID"), P_("Stock ID for secondary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-name: * * The icon name to use for the primary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_ICON_NAME_PRIMARY, g_param_spec_string ("primary-icon-name", P_("Primary icon name"), P_("Icon name for primary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-name: * * The icon name to use for the secondary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_ICON_NAME_SECONDARY, g_param_spec_string ("secondary-icon-name", P_("Secondary icon name"), P_("Icon name for secondary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-gicon: * * The #GIcon to use for the primary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_GICON_PRIMARY, g_param_spec_object ("primary-icon-gicon", P_("Primary GIcon"), P_("GIcon for primary icon"), G_TYPE_ICON, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-gicon: * * The #GIcon to use for the secondary icon for the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_GICON_SECONDARY, g_param_spec_object ("secondary-icon-gicon", P_("Secondary GIcon"), P_("GIcon for secondary icon"), G_TYPE_ICON, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-storage-type: * * The representation which is used for the primary icon of the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_STORAGE_TYPE_PRIMARY, g_param_spec_enum ("primary-icon-storage-type", P_("Primary storage type"), P_("The representation being used for primary icon"), GTK_TYPE_IMAGE_TYPE, GTK_IMAGE_EMPTY, GTK_PARAM_READABLE)); /** * GtkEntry:secondary-icon-storage-type: * * The representation which is used for the secondary icon of the entry. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_STORAGE_TYPE_SECONDARY, g_param_spec_enum ("secondary-icon-storage-type", P_("Secondary storage type"), P_("The representation being used for secondary icon"), GTK_TYPE_IMAGE_TYPE, GTK_IMAGE_EMPTY, GTK_PARAM_READABLE)); /** * GtkEntry:primary-icon-activatable: * * Whether the primary icon is activatable. * * GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release * signals only on sensitive, activatable icons. * * Sensitive, but non-activatable icons can be used for purely * informational purposes. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_ACTIVATABLE_PRIMARY, g_param_spec_boolean ("primary-icon-activatable", P_("Primary icon activatable"), P_("Whether the primary icon is activatable"), TRUE, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-activatable: * * Whether the secondary icon is activatable. * * GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release * signals only on sensitive, activatable icons. * * Sensitive, but non-activatable icons can be used for purely * informational purposes. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_ACTIVATABLE_SECONDARY, g_param_spec_boolean ("secondary-icon-activatable", P_("Secondary icon activatable"), P_("Whether the secondary icon is activatable"), TRUE, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-sensitive: * * Whether the primary icon is sensitive. * * An insensitive icon appears grayed out. GTK+ does not emit the * #GtkEntry::icon-press and #GtkEntry::icon-release signals and * does not allow DND from insensitive icons. * * An icon should be set insensitive if the action that would trigger * when clicked is currently not available. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_SENSITIVE_PRIMARY, g_param_spec_boolean ("primary-icon-sensitive", P_("Primary icon sensitive"), P_("Whether the primary icon is sensitive"), TRUE, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-sensitive: * * Whether the secondary icon is sensitive. * * An insensitive icon appears grayed out. GTK+ does not emit the * #GtkEntry::icon-press and #GtkEntry::icon-release signals and * does not allow DND from insensitive icons. * * An icon should be set insensitive if the action that would trigger * when clicked is currently not available. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_SENSITIVE_SECONDARY, g_param_spec_boolean ("secondary-icon-sensitive", P_("Secondary icon sensitive"), P_("Whether the secondary icon is sensitive"), TRUE, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-tooltip-text: * * The contents of the tooltip on the primary icon. * * Also see gtk_entry_set_icon_tooltip_text(). * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_TEXT_PRIMARY, g_param_spec_string ("primary-icon-tooltip-text", P_("Primary icon tooltip text"), P_("The contents of the tooltip on the primary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-tooltip-text: * * The contents of the tooltip on the secondary icon. * * Also see gtk_entry_set_icon_tooltip_text(). * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_TEXT_SECONDARY, g_param_spec_string ("secondary-icon-tooltip-text", P_("Secondary icon tooltip text"), P_("The contents of the tooltip on the secondary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:primary-icon-tooltip-markup: * * The contents of the tooltip on the primary icon, which is marked up * with the Pango text markup * language. * * Also see gtk_entry_set_icon_tooltip_markup(). * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_MARKUP_PRIMARY, g_param_spec_string ("primary-icon-tooltip-markup", P_("Primary icon tooltip markup"), P_("The contents of the tooltip on the primary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:secondary-icon-tooltip-markup: * * The contents of the tooltip on the secondary icon, which is marked up * with the Pango text markup * language. * * Also see gtk_entry_set_icon_tooltip_markup(). * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_MARKUP_SECONDARY, g_param_spec_string ("secondary-icon-tooltip-markup", P_("Secondary icon tooltip markup"), P_("The contents of the tooltip on the secondary icon"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:im-module: * * Which IM (input method) module should be used for this entry. * See #GtkIMContext. * * Setting this to a non-%NULL value overrides the * system-wide IM module setting. See the GtkSettings * #GtkSettings:gtk-im-module property. * * Since: 2.16 */ g_object_class_install_property (gobject_class, PROP_IM_MODULE, g_param_spec_string ("im-module", P_("IM module"), P_("Which IM module should be used"), NULL, GTK_PARAM_READWRITE)); /** * GtkEntry:completion: * * The auxiliary completion object to use with the entry. * * Since: 3.2 */ g_object_class_install_property (gobject_class, PROP_COMPLETION, g_param_spec_object ("completion", P_("Completion"), P_("The auxiliary completion object"), GTK_TYPE_ENTRY_COMPLETION, GTK_PARAM_READWRITE)); /** * GtkEntry:icon-prelight: * * The prelight style property determines whether activatable * icons prelight on mouseover. * * Since: 2.16 */ gtk_widget_class_install_style_property (widget_class, g_param_spec_boolean ("icon-prelight", P_("Icon Prelight"), P_("Whether activatable icons should prelight when hovered"), TRUE, GTK_PARAM_READABLE)); /** * GtkEntry:progress-border: * * The border around the progress bar in the entry. * * Since: 2.16 * * Deprecated: 3.4: Use the standard margin CSS property; * the value of this style property is ignored. */ gtk_widget_class_install_style_property (widget_class, g_param_spec_boxed ("progress-border", P_("Progress Border"), P_("Border around the progress bar"), GTK_TYPE_BORDER, GTK_PARAM_READABLE | G_PARAM_DEPRECATED)); /** * GtkEntry:invisible-char: * * The invisible character is used when masking entry contents (in * \"password mode\")"). When it is not explicitly set with the * #GtkEntry::invisible-char property, GTK+ determines the character * to use from a list of possible candidates, depending on availability * in the current font. * * This style property allows the theme to prepend a character * to the list of candidates. * * Since: 2.18 */ gtk_widget_class_install_style_property (widget_class, g_param_spec_unichar ("invisible-char", P_("Invisible character"), P_("The character to use when masking entry contents (in \"password mode\")"), 0, GTK_PARAM_READABLE)); /** * GtkEntry::populate-popup: * @entry: The entry on which the signal is emitted * @menu: the menu that is being populated * * The ::populate-popup signal gets emitted before showing the * context menu of the entry. * * If you need to add items to the context menu, connect * to this signal and append your menuitems to the @menu. */ signals[POPULATE_POPUP] = g_signal_new (I_("populate-popup"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkEntryClass, populate_popup), NULL, NULL, _gtk_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GTK_TYPE_MENU); /* Action signals */ /** * GtkEntry::activate: * @entry: The entry on which the signal is emitted * * A keybinding signal * which gets emitted when the user activates the entry. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control activation * programmatically. * * The default bindings for this signal are all forms of the Enter key. */ 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]; /** * GtkEntry::move-cursor: * @entry: the object which received the signal * @step: the granularity of the move, as a #GtkMovementStep * @count: the number of @step units to move * @extend_selection: %TRUE if the move should extend the selection * * The ::move-cursor signal is a * keybinding signal * which gets emitted when the user initiates a cursor movement. * If the cursor is not visible in @entry, this signal causes * the viewport to be moved instead. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control the cursor * programmatically. * * The default bindings for this signal come in two variants, * the variant with the Shift modifier extends the selection, * the variant without the Shift modifer does not. * There are too many key combinations to list them all here. * * Arrow keys move by individual characters/lines * Ctrl-arrow key combinations move by words/paragraphs * Home/End keys move to the ends of the buffer * */ 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); /** * GtkEntry::insert-at-cursor: * @entry: the object which received the signal * @string: the string to insert * * The ::insert-at-cursor signal is a * keybinding signal * which gets emitted when the user initiates the insertion of a * fixed string at the cursor. * * This signal has no default bindings. */ signals[INSERT_AT_CURSOR] = g_signal_new (I_("insert-at-cursor"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, insert_at_cursor), NULL, NULL, _gtk_marshal_VOID__STRING, G_TYPE_NONE, 1, G_TYPE_STRING); /** * GtkEntry::delete-from-cursor: * @entry: the object which received the signal * @type: the granularity of the deletion, as a #GtkDeleteType * @count: the number of @type units to delete * * The ::delete-from-cursor signal is a * keybinding signal * which gets emitted when the user initiates a text deletion. * * If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection * if there is one, otherwise it deletes the requested number * of characters. * * The default bindings for this signal are * Delete for deleting a character and Ctrl-Delete for * deleting a word. */ 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); /** * GtkEntry::backspace: * @entry: the object which received the signal * * The ::backspace signal is a * keybinding signal * which gets emitted when the user asks for it. * * The default bindings for this signal are * Backspace and Shift-Backspace. */ signals[BACKSPACE] = g_signal_new (I_("backspace"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, backspace), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkEntry::cut-clipboard: * @entry: the object which received the signal * * The ::cut-clipboard signal is a * keybinding signal * which gets emitted to cut the selection to the clipboard. * * The default bindings for this signal are * Ctrl-x and Shift-Delete. */ signals[CUT_CLIPBOARD] = g_signal_new (I_("cut-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, cut_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkEntry::copy-clipboard: * @entry: the object which received the signal * * The ::copy-clipboard signal is a * keybinding signal * which gets emitted to copy the selection to the clipboard. * * The default bindings for this signal are * Ctrl-c and Ctrl-Insert. */ signals[COPY_CLIPBOARD] = g_signal_new (I_("copy-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, copy_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkEntry::paste-clipboard: * @entry: the object which received the signal * * The ::paste-clipboard signal is a * keybinding signal * which gets emitted to paste the contents of the clipboard * into the text view. * * The default bindings for this signal are * Ctrl-v and Shift-Insert. */ signals[PASTE_CLIPBOARD] = g_signal_new (I_("paste-clipboard"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, paste_clipboard), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkEntry::toggle-overwrite: * @entry: the object which received the signal * * The ::toggle-overwrite signal is a * keybinding signal * which gets emitted to toggle the overwrite mode of the entry. * * The default bindings for this signal is Insert. */ signals[TOGGLE_OVERWRITE] = g_signal_new (I_("toggle-overwrite"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkEntryClass, toggle_overwrite), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkEntry::icon-press: * @entry: The entry on which the signal is emitted * @icon_pos: The position of the clicked icon * @event: (type Gdk.EventButton): the button press event * * The ::icon-press signal is emitted when an activatable icon * is clicked. * * Since: 2.16 */ signals[ICON_PRESS] = g_signal_new (I_("icon-press"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST, 0, NULL, NULL, _gtk_marshal_VOID__ENUM_BOXED, G_TYPE_NONE, 2, GTK_TYPE_ENTRY_ICON_POSITION, GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE); /** * GtkEntry::icon-release: * @entry: The entry on which the signal is emitted * @icon_pos: The position of the clicked icon * @event: (type Gdk.EventButton): the button release event * * The ::icon-release signal is emitted on the button release from a * mouse click over an activatable icon. * * Since: 2.16 */ signals[ICON_RELEASE] = g_signal_new (I_("icon-release"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST, 0, NULL, NULL, _gtk_marshal_VOID__ENUM_BOXED, G_TYPE_NONE, 2, GTK_TYPE_ENTRY_ICON_POSITION, GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE); /** * GtkEntry::preedit-changed: * @entry: the object which received the signal * @preedit: the current preedit string * * If an input method is used, the typed text will not immediately * be committed to the buffer. So if you are interested in the text, * connect to this signal. * * Since: 2.20 */ signals[PREEDIT_CHANGED] = g_signal_new_class_handler (I_("preedit-changed"), G_OBJECT_CLASS_TYPE (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, NULL, NULL, NULL, _gtk_marshal_VOID__STRING, G_TYPE_NONE, 1, G_TYPE_STRING); /* * Key bindings */ binding_set = gtk_binding_set_by_class (class); /* Moving the insertion point */ add_move_binding (binding_set, GDK_KEY_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (binding_set, GDK_KEY_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (binding_set, GDK_KEY_KP_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); add_move_binding (binding_set, GDK_KEY_KP_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); add_move_binding (binding_set, GDK_KEY_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (binding_set, GDK_KEY_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (binding_set, GDK_KEY_KP_Right, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, 1); add_move_binding (binding_set, GDK_KEY_KP_Left, GDK_CONTROL_MASK, GTK_MOVEMENT_WORDS, -1); add_move_binding (binding_set, GDK_KEY_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (binding_set, GDK_KEY_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (binding_set, GDK_KEY_KP_Home, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1); add_move_binding (binding_set, GDK_KEY_KP_End, 0, GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1); add_move_binding (binding_set, GDK_KEY_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (binding_set, GDK_KEY_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); add_move_binding (binding_set, GDK_KEY_KP_Home, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, -1); add_move_binding (binding_set, GDK_KEY_KP_End, GDK_CONTROL_MASK, GTK_MOVEMENT_BUFFER_ENDS, 1); /* Select all */ gtk_binding_entry_add_signal (binding_set, GDK_KEY_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_KEY_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_KEY_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_KEY_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_KEY_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_KEY_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_KEY_Return, 0, "activate", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_ISO_Enter, 0, "activate", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Enter, 0, "activate", 0); /* Deleting text */ gtk_binding_entry_add_signal (binding_set, GDK_KEY_Delete, 0, "delete-from-cursor", 2, G_TYPE_ENUM, GTK_DELETE_CHARS, G_TYPE_INT, 1); gtk_binding_entry_add_signal (binding_set, GDK_KEY_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_KEY_BackSpace, 0, "backspace", 0); /* Make this do the same as Backspace, to help with mis-typing */ gtk_binding_entry_add_signal (binding_set, GDK_KEY_BackSpace, GDK_SHIFT_MASK, "backspace", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_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_KEY_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_KEY_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_KEY_x, GDK_CONTROL_MASK, "cut-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_c, GDK_CONTROL_MASK, "copy-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_v, GDK_CONTROL_MASK, "paste-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_Delete, GDK_SHIFT_MASK, "cut-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_Insert, GDK_CONTROL_MASK, "copy-clipboard", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_Insert, GDK_SHIFT_MASK, "paste-clipboard", 0); /* Overwrite */ gtk_binding_entry_add_signal (binding_set, GDK_KEY_Insert, 0, "toggle-overwrite", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Insert, 0, "toggle-overwrite", 0); /** * GtkEntry:inner-border: * * Sets the text area's border between the text and the frame. * * Since: 2.10 * * Deprecated: 3.4: Use the standard border and padding CSS properties; * the value of this style property is ignored. */ 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 | G_PARAM_DEPRECATED)); g_type_class_add_private (gobject_class, sizeof (GtkEntryPrivate)); gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_ENTRY_ACCESSIBLE); } static void gtk_entry_editable_init (GtkEditableInterface *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; } /* for deprecated properties */ static void gtk_entry_do_set_inner_border (GtkEntry *entry, const GtkBorder *border) { 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"); } static const GtkBorder * gtk_entry_do_get_inner_border (GtkEntry *entry) { return g_object_get_qdata (G_OBJECT (entry), quark_inner_border); } static void gtk_entry_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkEntry *entry = GTK_ENTRY (object); GtkEntryPrivate *priv = entry->priv; switch (prop_id) { case PROP_BUFFER: gtk_entry_set_buffer (entry, g_value_get_object (value)); break; case PROP_EDITABLE: { gboolean new_value = g_value_get_boolean (value); if (new_value != priv->editable) { GtkWidget *widget = GTK_WIDGET (entry); if (!new_value) { _gtk_entry_reset_im_context (entry); if (gtk_widget_has_focus (widget)) gtk_im_context_focus_out (priv->im_context); priv->preedit_length = 0; priv->preedit_cursor = 0; } priv->editable = new_value; if (new_value && gtk_widget_has_focus (widget)) gtk_im_context_focus_in (priv->im_context); gtk_widget_queue_draw (widget); } } 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_do_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: priv->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_INVISIBLE_CHAR_SET: if (g_value_get_boolean (value)) priv->invisible_char_set = TRUE; else gtk_entry_unset_invisible_char (entry); break; case PROP_CAPS_LOCK_WARNING: priv->caps_lock_warning = g_value_get_boolean (value); break; case PROP_PROGRESS_FRACTION: gtk_entry_set_progress_fraction (entry, g_value_get_double (value)); break; case PROP_PROGRESS_PULSE_STEP: gtk_entry_set_progress_pulse_step (entry, g_value_get_double (value)); break; case PROP_PLACEHOLDER_TEXT: gtk_entry_set_placeholder_text (entry, g_value_get_string (value)); break; case PROP_PIXBUF_PRIMARY: gtk_entry_set_icon_from_pixbuf (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_object (value)); break; case PROP_PIXBUF_SECONDARY: gtk_entry_set_icon_from_pixbuf (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_object (value)); break; case PROP_STOCK_PRIMARY: gtk_entry_set_icon_from_stock (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_string (value)); break; case PROP_STOCK_SECONDARY: gtk_entry_set_icon_from_stock (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_string (value)); break; case PROP_ICON_NAME_PRIMARY: gtk_entry_set_icon_from_icon_name (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_string (value)); break; case PROP_ICON_NAME_SECONDARY: gtk_entry_set_icon_from_icon_name (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_string (value)); break; case PROP_GICON_PRIMARY: gtk_entry_set_icon_from_gicon (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_object (value)); break; case PROP_GICON_SECONDARY: gtk_entry_set_icon_from_gicon (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_object (value)); break; case PROP_ACTIVATABLE_PRIMARY: gtk_entry_set_icon_activatable (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_boolean (value)); break; case PROP_ACTIVATABLE_SECONDARY: gtk_entry_set_icon_activatable (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_boolean (value)); break; case PROP_SENSITIVE_PRIMARY: gtk_entry_set_icon_sensitive (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_boolean (value)); break; case PROP_SENSITIVE_SECONDARY: gtk_entry_set_icon_sensitive (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_boolean (value)); break; case PROP_TOOLTIP_TEXT_PRIMARY: gtk_entry_set_icon_tooltip_text (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_string (value)); break; case PROP_TOOLTIP_TEXT_SECONDARY: gtk_entry_set_icon_tooltip_text (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_string (value)); break; case PROP_TOOLTIP_MARKUP_PRIMARY: gtk_entry_set_icon_tooltip_markup (entry, GTK_ENTRY_ICON_PRIMARY, g_value_get_string (value)); break; case PROP_TOOLTIP_MARKUP_SECONDARY: gtk_entry_set_icon_tooltip_markup (entry, GTK_ENTRY_ICON_SECONDARY, g_value_get_string (value)); break; case PROP_IM_MODULE: g_free (priv->im_module); priv->im_module = g_value_dup_string (value); if (GTK_IS_IM_MULTICONTEXT (priv->im_context)) gtk_im_multicontext_set_context_id (GTK_IM_MULTICONTEXT (priv->im_context), priv->im_module); break; case PROP_EDITING_CANCELED: priv->editing_canceled = g_value_get_boolean (value); break; case PROP_COMPLETION: gtk_entry_set_completion (entry, GTK_ENTRY_COMPLETION (g_value_get_object (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) { GtkEntry *entry = GTK_ENTRY (object); GtkEntryPrivate *priv = entry->priv; switch (prop_id) { case PROP_BUFFER: g_value_set_object (value, gtk_entry_get_buffer (entry)); break; case PROP_CURSOR_POSITION: g_value_set_int (value, priv->current_pos); break; case PROP_SELECTION_BOUND: g_value_set_int (value, priv->selection_bound); break; case PROP_EDITABLE: g_value_set_boolean (value, priv->editable); break; case PROP_MAX_LENGTH: g_value_set_int (value, gtk_entry_buffer_get_max_length (get_buffer (entry))); break; case PROP_VISIBILITY: g_value_set_boolean (value, priv->visible); break; case PROP_HAS_FRAME: g_value_set_boolean (value, priv->has_frame); break; case PROP_INNER_BORDER: g_value_set_boxed (value, gtk_entry_do_get_inner_border (entry)); break; case PROP_INVISIBLE_CHAR: g_value_set_uint (value, priv->invisible_char); break; case PROP_ACTIVATES_DEFAULT: g_value_set_boolean (value, priv->activates_default); break; case PROP_WIDTH_CHARS: g_value_set_int (value, priv->width_chars); break; case PROP_SCROLL_OFFSET: g_value_set_int (value, priv->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, priv->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, priv->overwrite_mode); break; case PROP_TEXT_LENGTH: g_value_set_uint (value, gtk_entry_buffer_get_length (get_buffer (entry))); break; case PROP_INVISIBLE_CHAR_SET: g_value_set_boolean (value, priv->invisible_char_set); break; case PROP_IM_MODULE: g_value_set_string (value, priv->im_module); break; case PROP_CAPS_LOCK_WARNING: g_value_set_boolean (value, priv->caps_lock_warning); break; case PROP_PROGRESS_FRACTION: g_value_set_double (value, priv->progress_fraction); break; case PROP_PROGRESS_PULSE_STEP: g_value_set_double (value, priv->progress_pulse_fraction); break; case PROP_PLACEHOLDER_TEXT: g_value_set_string (value, gtk_entry_get_placeholder_text (entry)); break; case PROP_PIXBUF_PRIMARY: g_value_set_object (value, gtk_entry_get_icon_pixbuf (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_PIXBUF_SECONDARY: g_value_set_object (value, gtk_entry_get_icon_pixbuf (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_STOCK_PRIMARY: g_value_set_string (value, gtk_entry_get_icon_stock (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_STOCK_SECONDARY: g_value_set_string (value, gtk_entry_get_icon_stock (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_ICON_NAME_PRIMARY: g_value_set_string (value, gtk_entry_get_icon_name (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_ICON_NAME_SECONDARY: g_value_set_string (value, gtk_entry_get_icon_name (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_GICON_PRIMARY: g_value_set_object (value, gtk_entry_get_icon_gicon (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_GICON_SECONDARY: g_value_set_object (value, gtk_entry_get_icon_gicon (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_STORAGE_TYPE_PRIMARY: g_value_set_enum (value, gtk_entry_get_icon_storage_type (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_STORAGE_TYPE_SECONDARY: g_value_set_enum (value, gtk_entry_get_icon_storage_type (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_ACTIVATABLE_PRIMARY: g_value_set_boolean (value, gtk_entry_get_icon_activatable (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_ACTIVATABLE_SECONDARY: g_value_set_boolean (value, gtk_entry_get_icon_activatable (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_SENSITIVE_PRIMARY: g_value_set_boolean (value, gtk_entry_get_icon_sensitive (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_SENSITIVE_SECONDARY: g_value_set_boolean (value, gtk_entry_get_icon_sensitive (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_TOOLTIP_TEXT_PRIMARY: g_value_take_string (value, gtk_entry_get_icon_tooltip_text (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_TOOLTIP_TEXT_SECONDARY: g_value_take_string (value, gtk_entry_get_icon_tooltip_text (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_TOOLTIP_MARKUP_PRIMARY: g_value_take_string (value, gtk_entry_get_icon_tooltip_markup (entry, GTK_ENTRY_ICON_PRIMARY)); break; case PROP_TOOLTIP_MARKUP_SECONDARY: g_value_take_string (value, gtk_entry_get_icon_tooltip_markup (entry, GTK_ENTRY_ICON_SECONDARY)); break; case PROP_EDITING_CANCELED: g_value_set_boolean (value, priv->editing_canceled); break; case PROP_COMPLETION: g_value_set_object (value, G_OBJECT (gtk_entry_get_completion (entry))); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static gunichar find_invisible_char (GtkWidget *widget) { PangoLayout *layout; PangoAttrList *attr_list; gint i; gunichar invisible_chars [] = { 0, 0x25cf, /* BLACK CIRCLE */ 0x2022, /* BULLET */ 0x2731, /* HEAVY ASTERISK */ 0x273a /* SIXTEEN POINTED ASTERISK */ }; gtk_widget_style_get (widget, "invisible-char", &invisible_chars[0], NULL); layout = gtk_widget_create_pango_layout (widget, NULL); attr_list = pango_attr_list_new (); pango_attr_list_insert (attr_list, pango_attr_fallback_new (FALSE)); pango_layout_set_attributes (layout, attr_list); pango_attr_list_unref (attr_list); for (i = (invisible_chars[0] != 0 ? 0 : 1); i < G_N_ELEMENTS (invisible_chars); i++) { gchar text[7] = { 0, }; gint len, count; len = g_unichar_to_utf8 (invisible_chars[i], text); pango_layout_set_text (layout, text, len); count = pango_layout_get_unknown_glyphs_count (layout); if (count == 0) { g_object_unref (layout); return invisible_chars[i]; } } g_object_unref (layout); return '*'; } static void gtk_entry_init (GtkEntry *entry) { GtkStyleContext *context; GtkEntryPrivate *priv; entry->priv = G_TYPE_INSTANCE_GET_PRIVATE (entry, GTK_TYPE_ENTRY, GtkEntryPrivate); priv = entry->priv; gtk_widget_set_can_focus (GTK_WIDGET (entry), TRUE); gtk_widget_set_has_window (GTK_WIDGET (entry), FALSE); priv->editable = TRUE; priv->visible = TRUE; priv->dnd_position = -1; priv->width_chars = -1; priv->is_cell_renderer = FALSE; priv->editing_canceled = FALSE; priv->has_frame = TRUE; priv->truncate_multiline = FALSE; priv->shadow_type = GTK_SHADOW_IN; priv->xalign = 0.0; priv->caps_lock_warning = TRUE; priv->caps_lock_warning_shown = FALSE; priv->progress_fraction = 0.0; priv->progress_pulse_fraction = 0.1; 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(). */ priv->im_context = gtk_im_multicontext_new (); g_signal_connect (priv->im_context, "commit", G_CALLBACK (gtk_entry_commit_cb), entry); g_signal_connect (priv->im_context, "preedit-changed", G_CALLBACK (gtk_entry_preedit_changed_cb), entry); g_signal_connect (priv->im_context, "retrieve-surrounding", G_CALLBACK (gtk_entry_retrieve_surrounding_cb), entry); g_signal_connect (priv->im_context, "delete-surrounding", G_CALLBACK (gtk_entry_delete_surrounding_cb), entry); context = gtk_widget_get_style_context (GTK_WIDGET (entry)); gtk_style_context_add_class (context, GTK_STYLE_CLASS_ENTRY); gtk_entry_update_cached_style_values (entry); } static void gtk_entry_prepare_context_for_icon (GtkEntry *entry, GtkStyleContext *context, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; GtkWidget *widget; GtkStateFlags state; widget = GTK_WIDGET (entry); state = gtk_widget_get_state_flags (widget); state &= ~(GTK_STATE_FLAG_PRELIGHT); if ((state & GTK_STATE_FLAG_INSENSITIVE) || icon_info->insensitive) state |= GTK_STATE_FLAG_INSENSITIVE; else if (icon_info->prelight) state |= GTK_STATE_FLAG_PRELIGHT; gtk_style_context_save (context); gtk_style_context_set_state (context, state); gtk_style_context_add_class (context, GTK_STYLE_CLASS_IMAGE); if (gtk_widget_get_direction (GTK_WIDGET (entry)) == GTK_TEXT_DIR_RTL) { if (icon_pos == GTK_ENTRY_ICON_PRIMARY) gtk_style_context_add_class (context, GTK_STYLE_CLASS_RIGHT); else gtk_style_context_add_class (context, GTK_STYLE_CLASS_LEFT); } else { if (icon_pos == GTK_ENTRY_ICON_PRIMARY) gtk_style_context_add_class (context, GTK_STYLE_CLASS_LEFT); else gtk_style_context_add_class (context, GTK_STYLE_CLASS_RIGHT); } } static gint get_icon_width (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; GtkStyleContext *context; GtkBorder padding; gint width; if (!icon_info) return 0; context = gtk_widget_get_style_context (GTK_WIDGET (entry)); gtk_entry_prepare_context_for_icon (entry, context, icon_pos); gtk_style_context_get_padding (context, 0, &padding); _gtk_icon_helper_get_size (icon_info->icon_helper, context, &width, NULL); gtk_style_context_restore (context); if (width > 0) width += padding.left + padding.right; return width; } static void get_icon_allocations (GtkEntry *entry, GtkAllocation *primary, GtkAllocation *secondary) { GtkEntryPrivate *priv = entry->priv; gint x, y, width, height; get_text_area_size (entry, &x, &y, &width, &height); if (gtk_widget_has_focus (GTK_WIDGET (entry)) && !priv->interior_focus) y += priv->focus_width; primary->y = y; primary->height = height; primary->width = get_icon_width (entry, GTK_ENTRY_ICON_PRIMARY); secondary->y = y; secondary->height = height; secondary->width = get_icon_width (entry, GTK_ENTRY_ICON_SECONDARY); if (gtk_widget_get_direction (GTK_WIDGET (entry)) == GTK_TEXT_DIR_RTL) { primary->x = x + width - primary->width; secondary->x = x; } else { primary->x = x; secondary->x = x + width - secondary->width; } } static void begin_change (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; priv->change_count++; g_object_freeze_notify (G_OBJECT (entry)); } static void end_change (GtkEntry *entry) { GtkEditable *editable = GTK_EDITABLE (entry); GtkEntryPrivate *priv = entry->priv; g_return_if_fail (priv->change_count > 0); g_object_thaw_notify (G_OBJECT (entry)); 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 = entry->priv; if (priv->change_count == 0) g_signal_emit_by_name (editable, "changed"); else priv->real_changed = TRUE; } static void gtk_entry_destroy (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; priv->current_pos = priv->selection_bound = 0; _gtk_entry_reset_im_context (entry); gtk_entry_reset_layout (entry); if (priv->blink_timeout) { g_source_remove (priv->blink_timeout); priv->blink_timeout = 0; } if (priv->recompute_idle) { g_source_remove (priv->recompute_idle); priv->recompute_idle = 0; } GTK_WIDGET_CLASS (gtk_entry_parent_class)->destroy (widget); } static void gtk_entry_dispose (GObject *object) { GtkEntry *entry = GTK_ENTRY (object); GtkEntryPrivate *priv = entry->priv; GdkKeymap *keymap; gtk_entry_set_icon_from_pixbuf (entry, GTK_ENTRY_ICON_PRIMARY, NULL); gtk_entry_set_icon_tooltip_markup (entry, GTK_ENTRY_ICON_PRIMARY, NULL); gtk_entry_set_icon_from_pixbuf (entry, GTK_ENTRY_ICON_SECONDARY, NULL); gtk_entry_set_icon_tooltip_markup (entry, GTK_ENTRY_ICON_SECONDARY, NULL); if (priv->buffer) { buffer_disconnect_signals (entry); g_object_unref (priv->buffer); priv->buffer = NULL; } keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (object))); g_signal_handlers_disconnect_by_func (keymap, keymap_state_changed, entry); g_signal_handlers_disconnect_by_func (keymap, keymap_direction_changed, entry); G_OBJECT_CLASS (gtk_entry_parent_class)->dispose (object); } static void gtk_entry_finalize (GObject *object) { GtkEntry *entry = GTK_ENTRY (object); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; gint i; for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (icon_info->target_list != NULL) { gtk_target_list_unref (icon_info->target_list); icon_info->target_list = NULL; } g_clear_object (&icon_info->icon_helper); g_slice_free (EntryIconInfo, icon_info); priv->icons[i] = NULL; } } gtk_entry_set_completion (entry, NULL); if (priv->cached_layout) g_object_unref (priv->cached_layout); g_object_unref (priv->im_context); if (priv->blink_timeout) g_source_remove (priv->blink_timeout); if (priv->recompute_idle) g_source_remove (priv->recompute_idle); g_free (priv->placeholder_text); g_free (priv->im_module); G_OBJECT_CLASS (gtk_entry_parent_class)->finalize (object); } static DisplayMode gtk_entry_get_display_mode (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->visible) return DISPLAY_NORMAL; if (priv->invisible_char == 0 && priv->invisible_char_set) return DISPLAY_BLANK; return DISPLAY_INVISIBLE; } static gchar* gtk_entry_get_display_text (GtkEntry *entry, gint start_pos, gint end_pos) { GtkEntryPasswordHint *password_hint; GtkEntryPrivate *priv; gunichar invisible_char; const gchar *start; const gchar *end; const gchar *text; gchar char_str[7]; gint char_len; GString *str; guint length; gint i; priv = entry->priv; text = gtk_entry_buffer_get_text (get_buffer (entry)); length = gtk_entry_buffer_get_length (get_buffer (entry)); if (end_pos < 0) end_pos = length; if (start_pos > length) start_pos = length; if (end_pos <= start_pos) return g_strdup (""); else if (priv->visible) { start = g_utf8_offset_to_pointer (text, start_pos); end = g_utf8_offset_to_pointer (start, end_pos - start_pos); return g_strndup (start, end - start); } else { str = g_string_sized_new (length * 2); /* Figure out what our invisible char is and encode it */ if (!priv->invisible_char) invisible_char = priv->invisible_char_set ? ' ' : '*'; else invisible_char = priv->invisible_char; char_len = g_unichar_to_utf8 (invisible_char, char_str); /* * Add hidden characters for each character in the text * buffer. If there is a password hint, then keep that * character visible. */ password_hint = g_object_get_qdata (G_OBJECT (entry), quark_password_hint); for (i = start_pos; i < end_pos; ++i) { if (password_hint && i == password_hint->position) { start = g_utf8_offset_to_pointer (text, i); g_string_append_len (str, start, g_utf8_next_char (start) - start); } else { g_string_append_len (str, char_str, char_len); } } return g_string_free (str, FALSE); } } static void update_cursors (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; GdkDisplay *display; GdkCursor *cursor; gint i; for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (!_gtk_icon_helper_get_is_empty (icon_info->icon_helper) && icon_info->window != NULL) gdk_window_show_unraised (icon_info->window); /* The icon windows are not children of the visible entry window, * thus we can't just inherit the xterm cursor. Slight complication * here is that for the entry, insensitive => arrow cursor, but for * an icon in a sensitive entry, insensitive => xterm cursor. */ if (gtk_widget_is_sensitive (widget) && (icon_info->insensitive || (icon_info->nonactivatable && icon_info->target_list == NULL))) { display = gtk_widget_get_display (widget); cursor = gdk_cursor_new_for_display (display, GDK_XTERM); gdk_window_set_cursor (icon_info->window, cursor); g_object_unref (cursor); } else { gdk_window_set_cursor (icon_info->window, NULL); } } } } static void realize_icon_info (GtkWidget *widget, GtkEntryIconPosition icon_pos) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; GdkWindowAttr attributes; gint attributes_mask; g_return_if_fail (icon_info != NULL); attributes.x = 0; attributes.y = 0; attributes.width = 1; attributes.height = 1; attributes.window_type = GDK_WINDOW_CHILD; attributes.wclass = GDK_INPUT_ONLY; attributes.event_mask = gtk_widget_get_events (widget); attributes.event_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; icon_info->window = gdk_window_new (gtk_widget_get_window (widget), &attributes, attributes_mask); gdk_window_set_user_data (icon_info->window, widget); gtk_widget_queue_resize (widget); } static EntryIconInfo* construct_icon_info (GtkWidget *widget, GtkEntryIconPosition icon_pos) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info; g_return_val_if_fail (priv->icons[icon_pos] == NULL, NULL); icon_info = g_slice_new0 (EntryIconInfo); priv->icons[icon_pos] = icon_info; icon_info->icon_helper = _gtk_icon_helper_new (); if (gtk_widget_get_realized (widget)) realize_icon_info (widget, icon_pos); return icon_info; } static void gtk_entry_map (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; gint i; GTK_WIDGET_CLASS (gtk_entry_parent_class)->map (widget); gdk_window_show (priv->text_area); for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (!_gtk_icon_helper_get_is_empty (icon_info->icon_helper) && icon_info->window != NULL) gdk_window_show (icon_info->window); } } update_cursors (widget); } static void gtk_entry_unmap (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; gint i; for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (!_gtk_icon_helper_get_is_empty (icon_info->icon_helper) && icon_info->window != NULL) gdk_window_hide (icon_info->window); } } gdk_window_hide (priv->text_area); GTK_WIDGET_CLASS (gtk_entry_parent_class)->unmap (widget); } static void gtk_entry_realize (GtkWidget *widget) { GtkEntry *entry; GtkEntryPrivate *priv; EntryIconInfo *icon_info; GdkWindow *window; GdkWindowAttr attributes; gint attributes_mask; gint frame_x, frame_y; int i; gtk_widget_set_realized (widget, TRUE); window = gtk_widget_get_parent_window (widget); gtk_widget_set_window (widget, window); g_object_ref (window); entry = GTK_ENTRY (widget); priv = entry->priv; attributes.window_type = GDK_WINDOW_CHILD; attributes.wclass = GDK_INPUT_ONLY; attributes.event_mask = gtk_widget_get_events (widget); attributes.event_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; get_text_area_size (entry, &attributes.x, &attributes.y, &attributes.width, &attributes.height); get_frame_size (entry, TRUE, &frame_x, &frame_y, NULL, NULL); attributes.x += frame_x; attributes.y += frame_y; 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; } priv->text_area = gdk_window_new (gtk_widget_get_window (widget), &attributes, attributes_mask); gdk_window_set_user_data (priv->text_area, entry); if (attributes_mask & GDK_WA_CURSOR) g_object_unref (attributes.cursor); gtk_im_context_set_client_window (priv->im_context, priv->text_area); gtk_entry_adjust_scroll (entry); gtk_entry_update_primary_selection (entry); /* If the icon positions are already setup, create their windows. * Otherwise if they don't exist yet, then construct_icon_info() * will create the windows once the widget is already realized. */ for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (icon_info->window == NULL) realize_icon_info (widget, i); } } } static void gtk_entry_unrealize (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; GtkClipboard *clipboard; EntryIconInfo *icon_info; gint i; gtk_entry_reset_layout (entry); gtk_im_context_set_client_window (priv->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 (priv->text_area) { gdk_window_set_user_data (priv->text_area, NULL); gdk_window_destroy (priv->text_area); priv->text_area = NULL; } if (priv->popup_menu) { gtk_widget_destroy (priv->popup_menu); priv->popup_menu = NULL; } GTK_WIDGET_CLASS (gtk_entry_parent_class)->unrealize (widget); for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (icon_info->window != NULL) { gdk_window_destroy (icon_info->window); icon_info->window = NULL; } } } } void _gtk_entry_get_borders (GtkEntry *entry, GtkBorder *border_out) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); GtkBorder tmp = { 0, 0, 0, 0 }; GtkStyleContext *context; context = gtk_widget_get_style_context (widget); gtk_style_context_get_padding (context, 0, &tmp); if (priv->has_frame) { GtkBorder border; gtk_style_context_get_border (context, 0, &border); tmp.top += border.top; tmp.right += border.right; tmp.bottom += border.bottom; tmp.left += border.left; } if (!priv->interior_focus) { tmp.top += priv->focus_width; tmp.right += priv->focus_width; tmp.bottom += priv->focus_width; tmp.left += priv->focus_width; } if (border_out != NULL) *border_out = tmp; } static void gtk_entry_get_preferred_width (GtkWidget *widget, gint *minimum, gint *natural) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; PangoFontMetrics *metrics; GtkBorder borders; PangoContext *context; GtkStyleContext *style_context; GtkStateFlags state; gint icon_widths = 0; gint icon_width, i; gint width; context = gtk_widget_get_pango_context (widget); style_context = gtk_widget_get_style_context (widget); state = gtk_widget_get_state_flags (widget); metrics = pango_context_get_metrics (context, gtk_style_context_get_font (style_context, state), pango_context_get_language (context)); _gtk_entry_get_borders (entry, &borders); if (priv->width_chars < 0) width = MIN_ENTRY_WIDTH + borders.left + borders.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; width = char_pixels * priv->width_chars + borders.left + borders.right; } for (i = 0; i < MAX_ICONS; i++) { icon_width = get_icon_width (entry, i); if (icon_width > 0) icon_widths += icon_width; } if (icon_widths > width) width += icon_widths; pango_font_metrics_unref (metrics); *minimum = width; *natural = width; } static void gtk_entry_get_preferred_height (GtkWidget *widget, gint *minimum, gint *natural) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; PangoFontMetrics *metrics; GtkBorder borders; GtkStyleContext *style_context; GtkStateFlags state; PangoContext *context; gint height; context = gtk_widget_get_pango_context (widget); style_context = gtk_widget_get_style_context (widget); state = gtk_widget_get_state_flags (widget); metrics = pango_context_get_metrics (context, gtk_style_context_get_font (style_context, state), pango_context_get_language (context)); priv->ascent = pango_font_metrics_get_ascent (metrics); priv->descent = pango_font_metrics_get_descent (metrics); _gtk_entry_get_borders (entry, &borders); height = PANGO_PIXELS (priv->ascent + priv->descent) + borders.top + borders.bottom; pango_font_metrics_unref (metrics); *minimum = height; *natural = height; } static void place_windows (GtkEntry *entry) { GtkWidget *widget = GTK_WIDGET (entry); GtkEntryPrivate *priv = entry->priv; gint x, y, width, height; gint frame_x, frame_y; GtkAllocation primary; GtkAllocation secondary; EntryIconInfo *icon_info = NULL; get_frame_size (entry, TRUE, &frame_x, &frame_y, NULL, NULL); get_text_area_size (entry, &x, &y, &width, &height); get_icon_allocations (entry, &primary, &secondary); if (gtk_widget_has_focus (widget) && !priv->interior_focus) y += priv->focus_width; if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL) x += secondary.width; else x += primary.width; width -= primary.width + secondary.width; x += frame_x; y += frame_y; primary.x += frame_x; primary.y += frame_y; secondary.x += frame_x; secondary.y += frame_y; if ((icon_info = priv->icons[GTK_ENTRY_ICON_PRIMARY]) != NULL) gdk_window_move_resize (icon_info->window, primary.x, primary.y, primary.width, primary.height); if ((icon_info = priv->icons[GTK_ENTRY_ICON_SECONDARY]) != NULL) gdk_window_move_resize (icon_info->window, secondary.x, secondary.y, secondary.width, secondary.height); gdk_window_move_resize (priv->text_area, x, y, width, height); } static void gtk_entry_get_text_area_size (GtkEntry *entry, gint *x, gint *y, gint *width, gint *height) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); GtkAllocation allocation; GtkRequisition requisition; gint req_height; gint frame_height; GtkBorder borders; gtk_widget_get_preferred_size (widget, &requisition, NULL); req_height = requisition.height - gtk_widget_get_margin_top (widget) - gtk_widget_get_margin_bottom (widget); gtk_widget_get_allocation (widget, &allocation); _gtk_entry_get_borders (entry, &borders); if (gtk_widget_get_realized (widget)) get_frame_size (entry, TRUE, NULL, NULL, NULL, &frame_height); else frame_height = req_height; if (gtk_widget_has_focus (widget) && !priv->interior_focus) frame_height -= 2 * priv->focus_width; if (x) *x = borders.left; if (y) *y = floor ((frame_height - req_height) / 2) + borders.top; if (width) *width = allocation.width - borders.left - borders.right; if (height) *height = req_height - borders.top - borders.bottom; } 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 get_frame_size (GtkEntry *entry, gboolean relative_to_window, gint *x, gint *y, gint *width, gint *height) { GtkEntryPrivate *priv = entry->priv; GtkAllocation allocation; GtkRequisition requisition; GtkWidget *widget = GTK_WIDGET (entry); gint req_height; gtk_widget_get_preferred_size (widget, &requisition, NULL); req_height = requisition.height - gtk_widget_get_margin_top (widget) - gtk_widget_get_margin_bottom (widget); gtk_widget_get_allocation (widget, &allocation); if (x) *x = relative_to_window ? allocation.x : 0; if (y) { if (priv->is_cell_renderer) *y = 0; else *y = (allocation.height - req_height) / 2; if (relative_to_window) *y += allocation.y; } if (width) *width = allocation.width; if (height) { if (priv->is_cell_renderer) *height = allocation.height; else *height = req_height; } } static void gtk_entry_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkEntry *entry = GTK_ENTRY (widget); gtk_widget_set_allocation (widget, allocation); if (gtk_widget_get_realized (widget)) { GtkEntryCompletion* completion; place_windows (entry); gtk_entry_recompute (entry); completion = gtk_entry_get_completion (entry); if (completion && gtk_widget_get_mapped (completion->priv->popup_window)) _gtk_entry_completion_resize_popup (completion); } } static gboolean should_prelight (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; gboolean prelight; if (!icon_info) return FALSE; if (icon_info->nonactivatable && icon_info->target_list == NULL) return FALSE; if (icon_info->pressed) return FALSE; gtk_widget_style_get (GTK_WIDGET (entry), "icon-prelight", &prelight, NULL); return prelight; } static void draw_icon (GtkWidget *widget, cairo_t *cr, GtkEntryIconPosition icon_pos) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; gint x, y, width, height, pix_width, pix_height; GtkStyleContext *context; GtkBorder padding; if (!icon_info) return; width = gdk_window_get_width (icon_info->window); height = gdk_window_get_height (icon_info->window); /* size_allocate hasn't been called yet. These are the default values. */ if (width == 1 || height == 1) return; cairo_save (cr); gtk_cairo_transform_to_window (cr, widget, icon_info->window); context = gtk_widget_get_style_context (widget); gtk_entry_prepare_context_for_icon (entry, context, icon_pos); _gtk_icon_helper_get_size (icon_info->icon_helper, context, &pix_width, &pix_height); gtk_style_context_get_padding (context, 0, &padding); x = MAX (0, padding.left); y = MAX (0, (height - pix_height) / 2); _gtk_icon_helper_draw (icon_info->icon_helper, context, cr, x, y); gtk_style_context_restore (context); cairo_restore (cr); } static void gtk_entry_draw_frame (GtkWidget *widget, GtkStyleContext *context, cairo_t *cr) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gint x = 0, y = 0, width, height; gint frame_x, frame_y; cairo_save (cr); get_frame_size (GTK_ENTRY (widget), FALSE, &frame_x, &frame_y, &width, &height); cairo_translate (cr, frame_x, frame_y); /* Fix a problem with some themes which assume that entry->text_area's * width equals widget->window's width * http://bugzilla.gnome.org/show_bug.cgi?id=466000 */ if (GTK_IS_SPIN_BUTTON (widget)) { GtkBorder borders; gtk_entry_get_text_area_size (GTK_ENTRY (widget), &x, NULL, &width, NULL); _gtk_entry_get_borders (GTK_ENTRY (widget), &borders); x -= borders.left; width += borders.left + borders.right; } 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_render_background (context, cr, x, y, width, height); if (priv->has_frame) gtk_render_frame (context, cr, x, y, width, height); gtk_entry_draw_progress (widget, context, cr); if (gtk_widget_has_visible_focus (widget) && !priv->interior_focus) { x -= priv->focus_width; y -= priv->focus_width; width += 2 * priv->focus_width; height += 2 * priv->focus_width; gtk_render_focus (context, cr, 0, 0, width, height); } cairo_restore (cr); } static void gtk_entry_prepare_context_for_progress (GtkEntry *entry, GtkStyleContext *context) { GtkEntryPrivate *private = entry->priv; gtk_style_context_save (context); gtk_style_context_add_class (context, GTK_STYLE_CLASS_PROGRESSBAR); if (private->progress_pulse_mode) gtk_style_context_add_class (context, GTK_STYLE_CLASS_PULSE); } static void get_progress_area (GtkWidget *widget, gint *x, gint *y, gint *width, gint *height) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *private = entry->priv; GtkStyleContext *context; GtkBorder margin; get_frame_size (GTK_ENTRY (widget), FALSE, NULL, NULL, width, height); *x = 0; *y = 0; if (!private->interior_focus) { *x -= private->focus_width; *y -= private->focus_width; *width += 2 * private->focus_width; *height += 2 * private->focus_width; } context = gtk_widget_get_style_context (widget); gtk_entry_prepare_context_for_progress (entry, context); gtk_style_context_get_margin (context, 0, &margin); gtk_style_context_restore (context); *x += margin.left; *y += margin.top; *width -= margin.left + margin.right; *height -= margin.top + margin.bottom; if (private->progress_pulse_mode) { gdouble value = private->progress_pulse_current; *x += (gint) floor(value * (*width)); *width = (gint) ceil(private->progress_pulse_fraction * (*width)); } else if (private->progress_fraction > 0) { gdouble value = private->progress_fraction; if (gtk_widget_get_direction (GTK_WIDGET (entry)) == GTK_TEXT_DIR_RTL) { gint bar_width; bar_width = floor(value * (*width) + 0.5); *x += *width - bar_width; *width = bar_width; } else { *width = (gint) floor(value * (*width) + 0.5); } } else { *width = 0; *height = 0; } } static void gtk_entry_draw_progress (GtkWidget *widget, GtkStyleContext *context, cairo_t *cr) { GtkEntry *entry = GTK_ENTRY (widget); gint x, y, width, height; get_progress_area (widget, &x, &y, &width, &height); if ((width <= 0) || (height <= 0)) return; gtk_entry_prepare_context_for_progress (entry, context); gtk_render_activity (context, cr, x, y, width, height); gtk_style_context_restore (context); } static gint gtk_entry_draw (GtkWidget *widget, cairo_t *cr) { GtkEntry *entry = GTK_ENTRY (widget); GtkStyleContext *context; GtkEntryPrivate *priv = entry->priv; int i; context = gtk_widget_get_style_context (widget); /* Draw entry_bg, shadow, progress and focus */ gtk_entry_draw_frame (widget, context, cr); /* Draw text and cursor */ cairo_save (cr); gtk_cairo_transform_to_window (cr, widget, priv->text_area); if (priv->dnd_position != -1) gtk_entry_draw_cursor (GTK_ENTRY (widget), cr, CURSOR_DND); gtk_entry_draw_text (GTK_ENTRY (widget), cr); /* When no text is being displayed at all, don't show the cursor */ if (gtk_entry_get_display_mode (entry) != DISPLAY_BLANK && gtk_widget_has_focus (widget) && priv->selection_bound == priv->current_pos && priv->cursor_visible) gtk_entry_draw_cursor (GTK_ENTRY (widget), cr, CURSOR_STANDARD); cairo_restore (cr); /* Draw icons */ for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) draw_icon (widget, cr, i); } return FALSE; } static gint gtk_entry_enter_notify (GtkWidget *widget, GdkEventCrossing *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gint i; for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL && event->window == icon_info->window) { if (should_prelight (entry, i)) { icon_info->prelight = TRUE; gtk_widget_queue_draw (widget); } break; } } return FALSE; } static gint gtk_entry_leave_notify (GtkWidget *widget, GdkEventCrossing *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gint i; for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL && event->window == icon_info->window) { /* a grab means that we may never see the button release */ if (event->mode == GDK_CROSSING_GRAB || event->mode == GDK_CROSSING_GTK_GRAB) icon_info->pressed = FALSE; if (should_prelight (entry, i)) { icon_info->prelight = FALSE; gtk_widget_queue_draw (widget); } break; } } 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 = entry->priv; EntryIconInfo *icon_info = NULL; gint tmp_pos; gint sel_start, sel_end; gint i; for (i = 0; i < MAX_ICONS; i++) { icon_info = priv->icons[i]; if (!icon_info || icon_info->insensitive) continue; if (event->window == icon_info->window) { if (should_prelight (entry, i)) { icon_info->prelight = FALSE; gtk_widget_queue_draw (widget); } priv->start_x = event->x; priv->start_y = event->y; icon_info->pressed = TRUE; if (!icon_info->nonactivatable) g_signal_emit (entry, signals[ICON_PRESS], 0, i, event); return TRUE; } } if (event->window != priv->text_area || (priv->button && event->button != priv->button)) return FALSE; gtk_entry_reset_blink_time (entry); priv->button = event->button; if (!gtk_widget_has_focus (widget)) { priv->in_click = TRUE; gtk_widget_grab_focus (widget); priv->in_click = FALSE; } tmp_pos = gtk_entry_find_position (entry, event->x + priv->scroll_offset); if (gdk_event_triggers_context_menu ((GdkEvent *) event)) { gtk_entry_do_popup (entry, event); priv->button = 0; /* Don't wait for release, since the menu will gtk_grab_add */ return TRUE; } else if (event->button == GDK_BUTTON_PRIMARY) { gboolean have_selection = gtk_editable_get_selection_bounds (editable, &sel_start, &sel_end); priv->select_words = FALSE; priv->select_lines = FALSE; if (event->state & gtk_widget_get_modifier_mask (widget, GDK_MODIFIER_INTENT_EXTEND_SELECTION)) { _gtk_entry_reset_im_context (entry); if (!have_selection) /* select from the current position to the clicked position */ sel_start = sel_end = priv->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: priv->select_words = TRUE; gtk_entry_select_word (entry); break; case GDK_3BUTTON_PRESS: priv->select_lines = TRUE; gtk_entry_select_line (entry); break; default: break; } start = MIN (priv->current_pos, priv->selection_bound); start = MIN (sel_start, start); end = MAX (priv->current_pos, priv->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 + priv->scroll_offset)) { /* Click inside the selection - we'll either start a drag, or * clear the selection */ priv->in_drag = TRUE; priv->drag_start_x = event->x + priv->scroll_offset; priv->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 * priv->in_drag which may have been set above */ priv->in_drag = FALSE; priv->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 * priv->in_drag which may have been set above */ priv->in_drag = FALSE; priv->select_lines = TRUE; gtk_entry_select_line (entry); break; default: break; } return TRUE; } else if (event->button == GDK_BUTTON_MIDDLE && event->type == GDK_BUTTON_PRESS) { if (priv->editable) { priv->insert_pos = tmp_pos; gtk_entry_paste (entry, GDK_SELECTION_PRIMARY); return TRUE; } else { gtk_widget_error_bell (widget); } } return FALSE; } static gint gtk_entry_button_release (GtkWidget *widget, GdkEventButton *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; gint i; for (i = 0; i < MAX_ICONS; i++) { icon_info = priv->icons[i]; if (!icon_info || icon_info->insensitive) continue; if (event->window == icon_info->window) { icon_info->pressed = FALSE; if (should_prelight (entry, i) && event->x >= 0 && event->y >= 0 && event->x < gdk_window_get_width (icon_info->window) && event->y < gdk_window_get_height (icon_info->window)) { icon_info->prelight = TRUE; gtk_widget_queue_draw (widget); } if (!icon_info->nonactivatable) g_signal_emit (entry, signals[ICON_RELEASE], 0, i, event); return TRUE; } } if (event->window != priv->text_area || priv->button != event->button) return FALSE; if (priv->in_drag) { gint tmp_pos = gtk_entry_find_position (entry, priv->drag_start_x); gtk_editable_set_position (GTK_EDITABLE (entry), tmp_pos); priv->in_drag = 0; } priv->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); GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = NULL; gint tmp_pos; gint i; for (i = 0; i < MAX_ICONS; i++) { icon_info = priv->icons[i]; if (!icon_info || icon_info->insensitive) continue; if (event->window == icon_info->window) { if (icon_info->pressed && icon_info->target_list != NULL && gtk_drag_check_threshold (widget, priv->start_x, priv->start_y, event->x, event->y)) { icon_info->in_drag = TRUE; icon_info->pressed = FALSE; gtk_drag_begin (widget, icon_info->target_list, icon_info->actions, 1, (GdkEvent*)event); } return TRUE; } } if (priv->mouse_cursor_obscured) { GdkCursor *cursor; cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget), GDK_XTERM); gdk_window_set_cursor (priv->text_area, cursor); g_object_unref (cursor); priv->mouse_cursor_obscured = FALSE; } if (event->window != priv->text_area || priv->button != GDK_BUTTON_PRIMARY) return FALSE; if (priv->select_lines) return TRUE; gdk_event_request_motions (event); if (priv->in_drag) { if (gtk_entry_get_display_mode (entry) == DISPLAY_NORMAL && gtk_drag_check_threshold (widget, priv->drag_start_x, priv->drag_start_y, event->x + priv->scroll_offset, event->y)) { GdkDragContext *context; GtkTargetList *target_list = gtk_target_list_new (NULL, 0); guint actions = priv->editable ? GDK_ACTION_COPY | GDK_ACTION_MOVE : GDK_ACTION_COPY; gchar *text = NULL; cairo_surface_t *surface; gtk_target_list_add_text_targets (target_list, 0); text = _gtk_entry_get_selected_text (entry); surface = _gtk_text_util_create_drag_icon (widget, text, -1); context = gtk_drag_begin (widget, target_list, actions, priv->button, (GdkEvent *)event); if (surface) gtk_drag_set_icon_surface (context, surface); else gtk_drag_set_icon_default (context); if (surface) cairo_surface_destroy (surface); g_free (text); priv->in_drag = FALSE; priv->button = 0; gtk_target_list_unref (target_list); } } else { if (event->y < 0) tmp_pos = 0; else if (event->y >= gdk_window_get_height (priv->text_area)) tmp_pos = gtk_entry_buffer_get_length (get_buffer (entry)); else tmp_pos = gtk_entry_find_position (entry, event->x + priv->scroll_offset); if (priv->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 = priv->current_pos; bound = priv->selection_bound; old_min = MIN(priv->current_pos, priv->selection_bound); old_max = MAX(priv->current_pos, priv->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 (priv->current_pos != min) pos = max; } else { if (priv->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) { GdkDisplay *display; GdkCursor *cursor; display = gdk_window_get_display (window); cursor = gdk_cursor_new_for_display (display, GDK_BLANK_CURSOR); gdk_window_set_cursor (window, cursor); g_object_unref (cursor); } static void gtk_entry_obscure_mouse_cursor (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->mouse_cursor_obscured) return; set_invisible_cursor (priv->text_area); priv->mouse_cursor_obscured = TRUE; } static gint gtk_entry_key_press (GtkWidget *widget, GdkEventKey *event) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gtk_entry_reset_blink_time (entry); gtk_entry_pend_cursor_blink (entry); if (priv->editable) { if (gtk_im_context_filter_keypress (priv->im_context, event)) { gtk_entry_obscure_mouse_cursor (entry); priv->need_im_reset = TRUE; return TRUE; } } if (event->keyval == GDK_KEY_Return || event->keyval == GDK_KEY_KP_Enter || event->keyval == GDK_KEY_ISO_Enter || event->keyval == GDK_KEY_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 (!priv->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); GtkEntryPrivate *priv = entry->priv; if (priv->editable) { if (gtk_im_context_filter_keypress (priv->im_context, event)) { priv->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); GtkEntryPrivate *priv = entry->priv; GdkKeymap *keymap; gtk_widget_queue_draw (widget); keymap = gdk_keymap_get_for_display (gtk_widget_get_display (widget)); if (priv->editable) { priv->need_im_reset = TRUE; gtk_im_context_focus_in (priv->im_context); keymap_state_changed (keymap, entry); g_signal_connect (keymap, "state-changed", G_CALLBACK (keymap_state_changed), entry); } g_signal_connect (keymap, "direction-changed", G_CALLBACK (keymap_direction_changed), entry); if (gtk_entry_buffer_get_bytes (get_buffer (entry)) == 0 && priv->placeholder_text != NULL) { gtk_entry_recompute (entry); } else { 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); GtkEntryPrivate *priv = entry->priv; GtkEntryCompletion *completion; GdkKeymap *keymap; gtk_widget_queue_draw (widget); keymap = gdk_keymap_get_for_display (gtk_widget_get_display (widget)); if (priv->editable) { priv->need_im_reset = TRUE; gtk_im_context_focus_out (priv->im_context); remove_capslock_feedback (entry); } if (gtk_entry_buffer_get_bytes (get_buffer (entry)) == 0 && priv->placeholder_text != NULL) { gtk_entry_recompute (entry); } else { gtk_entry_check_cursor_blink (entry); } g_signal_handlers_disconnect_by_func (keymap, keymap_state_changed, entry); g_signal_handlers_disconnect_by_func (keymap, 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); GtkEntryPrivate *priv = entry->priv; gboolean select_on_focus; GTK_WIDGET_CLASS (gtk_entry_parent_class)->grab_focus (widget); if (priv->editable && !priv->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_flags_changed (GtkWidget *widget, GtkStateFlags previous_state) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; GdkCursor *cursor; if (gtk_widget_get_realized (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 (priv->text_area, cursor); if (cursor) g_object_unref (cursor); priv->mouse_cursor_obscured = FALSE; update_cursors (widget); } if (!gtk_widget_is_sensitive (widget)) { /* Clear any selection */ gtk_editable_select_region (GTK_EDITABLE (entry), priv->current_pos, priv->current_pos); } gtk_entry_update_cached_style_values (entry); } 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) { g_object_ref (editable); /* * The incoming text may a password or other secret. We make sure * not to copy it into temporary buffers. */ g_signal_emit_by_name (editable, "insert-text", new_text, new_text_length, position); g_object_unref (editable); } static void gtk_entry_delete_text (GtkEditable *editable, gint start_pos, gint 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); const gchar *text; gint text_length; gint start_index, end_index; text = gtk_entry_buffer_get_text (get_buffer (entry)); text_length = gtk_entry_buffer_get_length (get_buffer (entry)); if (end_pos < 0) end_pos = text_length; start_pos = MIN (text_length, start_pos); end_pos = MIN (text_length, end_pos); start_index = g_utf8_offset_to_pointer (text, start_pos) - text; end_index = g_utf8_offset_to_pointer (text, end_pos) - text; return g_strndup (text + start_index, end_index - start_index); } static void gtk_entry_real_set_position (GtkEditable *editable, gint position) { GtkEntry *entry = GTK_ENTRY (editable); GtkEntryPrivate *priv = entry->priv; guint length; length = gtk_entry_buffer_get_length (get_buffer (entry)); if (position < 0 || position > length) position = length; if (position != priv->current_pos || position != priv->selection_bound) { _gtk_entry_reset_im_context (entry); gtk_entry_set_positions (entry, position, position); } } static gint gtk_entry_get_position (GtkEditable *editable) { GtkEntry *entry = GTK_ENTRY (editable); GtkEntryPrivate *priv = entry->priv; return priv->current_pos; } static void gtk_entry_set_selection_bounds (GtkEditable *editable, gint start, gint end) { GtkEntry *entry = GTK_ENTRY (editable); guint length; length = gtk_entry_buffer_get_length (get_buffer (entry)); if (start < 0) start = length; if (end < 0) end = length; _gtk_entry_reset_im_context (entry); gtk_entry_set_positions (entry, MIN (end, length), MIN (start, 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); GtkEntryPrivate *priv = entry->priv; *start = priv->selection_bound; *end = priv->current_pos; return (priv->selection_bound != priv->current_pos); } static void icon_theme_changed (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; gint i; for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) _gtk_icon_helper_invalidate (icon_info->icon_helper); } gtk_widget_queue_draw (GTK_WIDGET (entry)); } static void gtk_entry_update_cached_style_values (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; gint focus_width; gboolean interior_focus; gtk_widget_style_get (GTK_WIDGET (entry), "focus-line-width", &focus_width, "interior-focus", &interior_focus, NULL); priv->focus_width = focus_width; priv->interior_focus = interior_focus; if (!priv->invisible_char_set) { gunichar ch = find_invisible_char (GTK_WIDGET (entry)); if (priv->invisible_char != ch) { priv->invisible_char = ch; g_object_notify (G_OBJECT (entry), "invisible-char"); } } } static void gtk_entry_style_updated (GtkWidget *widget) { GtkEntry *entry = GTK_ENTRY (widget); GTK_WIDGET_CLASS (gtk_entry_parent_class)->style_updated (widget); gtk_entry_update_cached_style_values (entry); gtk_entry_recompute (entry); icon_theme_changed (entry); } /* 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) { GtkEntryPrivate *priv = entry->priv; if (key_event->keyval == GDK_KEY_Escape) { priv->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_KEY_Up || key_event->keyval == GDK_KEY_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) { GtkEntry *entry = GTK_ENTRY (cell_editable); GtkEntryPrivate *priv = entry->priv; priv->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->source_id) g_source_remove (password_hint->source_id); g_slice_free (GtkEntryPasswordHint, password_hint); } static gboolean gtk_entry_remove_password_hint (gpointer data) { GtkEntryPasswordHint *password_hint = g_object_get_qdata (data, quark_password_hint); password_hint->position = -1; /* Force the string to be redrawn, but now without a visible character */ gtk_entry_recompute (GTK_ENTRY (data)); return FALSE; } /* Default signal handlers */ static void gtk_entry_real_insert_text (GtkEditable *editable, const gchar *new_text, gint new_text_length, gint *position) { guint n_inserted; gint n_chars; n_chars = g_utf8_strlen (new_text, new_text_length); /* * The actual insertion into the buffer. This will end up firing the * following signal handlers: buffer_inserted_text(), buffer_notify_display_text(), * buffer_notify_text(), buffer_notify_length() */ begin_change (GTK_ENTRY (editable)); n_inserted = gtk_entry_buffer_insert_text (get_buffer (GTK_ENTRY (editable)), *position, new_text, n_chars); end_change (GTK_ENTRY (editable)); if (n_inserted != n_chars) gtk_widget_error_bell (GTK_WIDGET (editable)); *position += n_inserted; } static void gtk_entry_real_delete_text (GtkEditable *editable, gint start_pos, gint end_pos) { /* * The actual deletion from the buffer. This will end up firing the * following signal handlers: buffer_deleted_text(), buffer_notify_display_text(), * buffer_notify_text(), buffer_notify_length() */ begin_change (GTK_ENTRY (editable)); gtk_entry_buffer_delete_text (get_buffer (GTK_ENTRY (editable)), start_pos, end_pos - start_pos); end_change (GTK_ENTRY (editable)); } /* GtkEntryBuffer signal handlers */ static void buffer_inserted_text (GtkEntryBuffer *buffer, guint position, const gchar *chars, guint n_chars, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; guint password_hint_timeout; guint current_pos; gint selection_bound; current_pos = priv->current_pos; if (current_pos > position) current_pos += n_chars; selection_bound = priv->selection_bound; if (selection_bound > position) selection_bound += n_chars; gtk_entry_set_positions (entry, current_pos, selection_bound); /* Calculate the password hint if it needs to be displayed. */ if (n_chars == 1 && !priv->visible) { 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); } password_hint->position = position; if (password_hint->source_id) g_source_remove (password_hint->source_id); password_hint->source_id = gdk_threads_add_timeout (password_hint_timeout, (GSourceFunc)gtk_entry_remove_password_hint, entry); } } } static void buffer_deleted_text (GtkEntryBuffer *buffer, guint position, guint n_chars, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; guint end_pos = position + n_chars; gint selection_bound; guint current_pos; current_pos = priv->current_pos; if (current_pos > position) current_pos -= MIN (current_pos, end_pos) - position; selection_bound = priv->selection_bound; if (selection_bound > position) selection_bound -= MIN (selection_bound, end_pos) - position; gtk_entry_set_positions (entry, current_pos, selection_bound); /* We might have deleted the selection */ gtk_entry_update_primary_selection (entry); /* Disable the password hint if one exists. */ if (!priv->visible) { GtkEntryPasswordHint *password_hint = g_object_get_qdata (G_OBJECT (entry), quark_password_hint); if (password_hint) { if (password_hint->source_id) g_source_remove (password_hint->source_id); password_hint->source_id = 0; password_hint->position = -1; } } } static void buffer_notify_text (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry) { gtk_entry_recompute (entry); emit_changed (entry); g_object_notify (G_OBJECT (entry), "text"); } static void buffer_notify_length (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry) { g_object_notify (G_OBJECT (entry), "text-length"); } static void buffer_notify_max_length (GtkEntryBuffer *buffer, GParamSpec *spec, GtkEntry *entry) { g_object_notify (G_OBJECT (entry), "max-length"); } static void buffer_connect_signals (GtkEntry *entry) { g_signal_connect (get_buffer (entry), "inserted-text", G_CALLBACK (buffer_inserted_text), entry); g_signal_connect (get_buffer (entry), "deleted-text", G_CALLBACK (buffer_deleted_text), entry); g_signal_connect (get_buffer (entry), "notify::text", G_CALLBACK (buffer_notify_text), entry); g_signal_connect (get_buffer (entry), "notify::length", G_CALLBACK (buffer_notify_length), entry); g_signal_connect (get_buffer (entry), "notify::max-length", G_CALLBACK (buffer_notify_max_length), entry); } static void buffer_disconnect_signals (GtkEntry *entry) { g_signal_handlers_disconnect_by_func (get_buffer (entry), buffer_inserted_text, entry); g_signal_handlers_disconnect_by_func (get_buffer (entry), buffer_deleted_text, entry); g_signal_handlers_disconnect_by_func (get_buffer (entry), buffer_notify_text, entry); g_signal_handlers_disconnect_by_func (get_buffer (entry), buffer_notify_length, entry); g_signal_handlers_disconnect_by_func (get_buffer (entry), buffer_notify_max_length, entry); } /* 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) { GtkEntryPrivate *priv = entry->priv; 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 == priv->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) { GtkEntryPrivate *priv = entry->priv; gint new_pos = priv->current_pos; _gtk_entry_reset_im_context (entry); if (priv->current_pos != priv->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, priv->current_pos); gint bound_x = get_better_cursor_x (entry, priv->selection_bound); if (count <= 0) new_pos = current_x < bound_x ? priv->current_pos : priv->selection_bound; else new_pos = current_x > bound_x ? priv->current_pos : priv->selection_bound; break; } case GTK_MOVEMENT_LOGICAL_POSITIONS: case GTK_MOVEMENT_WORDS: if (count < 0) new_pos = MIN (priv->current_pos, priv->selection_bound); else new_pos = MAX (priv->current_pos, priv->selection_bound); break; case GTK_MOVEMENT_DISPLAY_LINE_ENDS: case GTK_MOVEMENT_PARAGRAPH_ENDS: case GTK_MOVEMENT_BUFFER_ENDS: new_pos = count < 0 ? 0 : gtk_entry_buffer_get_length (get_buffer (entry)); 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 (priv->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 (priv->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 : gtk_entry_buffer_get_length (get_buffer (entry)); if (priv->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), priv->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) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint pos = priv->current_pos; if (priv->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) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint start_pos = priv->current_pos; gint end_pos = priv->current_pos; gint old_n_bytes = gtk_entry_buffer_get_bytes (get_buffer (entry)); _gtk_entry_reset_im_context (entry); if (!priv->editable) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } if (priv->selection_bound != priv->current_pos) { gtk_editable_delete_selection (editable); return; } switch (type) { case GTK_DELETE_CHARS: end_pos = gtk_entry_move_logically (entry, priv->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, priv->current_pos); else gtk_editable_delete_text (editable, priv->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 (gtk_entry_buffer_get_bytes (get_buffer (entry)) == old_n_bytes) gtk_widget_error_bell (GTK_WIDGET (entry)); gtk_entry_pend_cursor_blink (entry); } static void gtk_entry_backspace (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint prev_pos; _gtk_entry_reset_im_context (entry); if (!priv->editable) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } if (priv->selection_bound != priv->current_pos) { gtk_editable_delete_selection (editable); return; } prev_pos = gtk_entry_move_logically (entry, priv->current_pos, -1); if (prev_pos < priv->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); /* Deleting parts of characters */ if (log_attrs[priv->current_pos].backspace_deletes_character) { gchar *cluster_text; gchar *normalized_text; glong len; cluster_text = gtk_entry_get_display_text (entry, prev_pos, priv->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, priv->current_pos); if (len > 1) { gint pos = priv->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, priv->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) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; gchar *str; if (gtk_editable_get_selection_bounds (editable, &start, &end)) { if (!priv->visible) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } str = gtk_entry_get_display_text (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) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; if (!priv->visible) { gtk_widget_error_bell (GTK_WIDGET (entry)); return; } gtk_entry_copy_clipboard (entry); if (priv->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) { GtkEntryPrivate *priv = entry->priv; if (priv->editable) gtk_entry_paste (entry, GDK_SELECTION_CLIPBOARD); else gtk_widget_error_bell (GTK_WIDGET (entry)); } static void gtk_entry_delete_cb (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint start, end; if (priv->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) { GtkEntryPrivate *priv = entry->priv; priv->overwrite_mode = !priv->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) { GtkEntryPrivate *priv = entry->priv; GtkWindow *window; GtkWidget *default_widget, *focus_widget; GtkWidget *toplevel; GtkWidget *widget; widget = GTK_WIDGET (entry); if (priv->activates_default) { toplevel = gtk_widget_get_toplevel (widget); if (GTK_IS_WINDOW (toplevel)) { window = GTK_WINDOW (toplevel); if (window) { default_widget = gtk_window_get_default_widget (window); focus_widget = gtk_window_get_focus (window); if (widget != default_widget && !(widget == focus_widget && (!default_widget || !gtk_widget_get_sensitive (default_widget)))) gtk_window_activate_default (window); } } } } static void 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) { GtkEntryPrivate *priv = entry->priv; if (priv->editable) gtk_entry_enter_text (entry, str); } static void gtk_entry_preedit_changed_cb (GtkIMContext *context, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->editable) { gchar *preedit_string; gint cursor_pos; gtk_im_context_get_preedit_string (priv->im_context, &preedit_string, NULL, &cursor_pos); g_signal_emit (entry, signals[PREEDIT_CHANGED], 0, preedit_string); priv->preedit_length = strlen (preedit_string); cursor_pos = CLAMP (cursor_pos, 0, g_utf8_strlen (preedit_string, -1)); priv->preedit_cursor = cursor_pos; g_free (preedit_string); gtk_entry_recompute (entry); } } static gboolean gtk_entry_retrieve_surrounding_cb (GtkIMContext *context, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; gchar *text; /* XXXX ??? does this even make sense when text is not visible? Should we return FALSE? */ text = gtk_entry_get_display_text (entry, 0, -1); gtk_im_context_set_surrounding (context, text, strlen (text), /* Length in bytes */ g_utf8_offset_to_pointer (text, priv->current_pos) - text); g_free (text); return TRUE; } static gboolean gtk_entry_delete_surrounding_cb (GtkIMContext *slave, gint offset, gint n_chars, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->editable) gtk_editable_delete_text (GTK_EDITABLE (entry), priv->current_pos + offset, priv->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) { GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (entry); gint tmp_pos; gboolean old_need_im_reset; old_need_im_reset = priv->need_im_reset; priv->need_im_reset = FALSE; if (gtk_editable_get_selection_bounds (editable, NULL, NULL)) gtk_editable_delete_selection (editable); else { if (priv->overwrite_mode) gtk_entry_delete_from_cursor (entry, GTK_DELETE_CHARS, 1); } tmp_pos = priv->current_pos; gtk_editable_insert_text (editable, str, strlen (str), &tmp_pos); gtk_editable_set_position (editable, tmp_pos); priv->need_im_reset = old_need_im_reset; } /* All changes to priv->current_pos and priv->selection_bound * should go through this function. */ static void gtk_entry_set_positions (GtkEntry *entry, gint current_pos, gint selection_bound) { GtkEntryPrivate *priv = entry->priv; gboolean changed = FALSE; g_object_freeze_notify (G_OBJECT (entry)); if (current_pos != -1 && priv->current_pos != current_pos) { priv->current_pos = current_pos; changed = TRUE; g_object_notify (G_OBJECT (entry), "cursor-position"); } if (selection_bound != -1 && priv->selection_bound != selection_bound) { priv->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) { GtkEntryPrivate *priv = entry->priv; if (priv->cached_layout) { g_object_unref (priv->cached_layout); priv->cached_layout = NULL; } } static void update_im_cursor_location (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; GdkRectangle area; gint strong_x; gint strong_xoffset; gint area_width, area_height; gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &strong_x, NULL); gtk_entry_get_text_area_size (entry, NULL, NULL, &area_width, &area_height); strong_xoffset = strong_x - priv->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 (priv->im_context, &area); } static gboolean recompute_idle_func (gpointer data) { GtkEntry *entry = GTK_ENTRY (data); GtkEntryPrivate *priv = entry->priv; priv->recompute_idle = 0; if (gtk_widget_has_screen (GTK_WIDGET (entry))) { gtk_entry_adjust_scroll (entry); gtk_widget_queue_draw (GTK_WIDGET (entry)); update_im_cursor_location (entry); } return FALSE; } static void gtk_entry_recompute (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; gtk_entry_reset_layout (entry); gtk_entry_check_cursor_blink (entry); if (!priv->recompute_idle) { priv->recompute_idle = gdk_threads_add_idle_full (G_PRIORITY_HIGH_IDLE + 15, /* between resize and redraw */ recompute_idle_func, entry, NULL); } } static void gtk_entry_get_placeholder_text_color (GtkEntry *entry, PangoColor *color) { GtkWidget *widget = GTK_WIDGET (entry); GtkStyleContext *context; GdkRGBA fg = { 0.5, 0.5, 0.5 }; context = gtk_widget_get_style_context (widget); gtk_style_context_lookup_color (context, "placeholder_text_color", &fg); color->red = CLAMP (fg.red * 65535. + 0.5, 0, 65535); color->green = CLAMP (fg.green * 65535. + 0.5, 0, 65535); color->blue = CLAMP (fg.blue * 65535. + 0.5, 0, 65535); } static inline gboolean show_placeholder_text (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (!gtk_widget_has_focus (GTK_WIDGET (entry)) && gtk_entry_buffer_get_bytes (get_buffer (entry)) == 0 && priv->placeholder_text != NULL) return TRUE; return FALSE; } static PangoLayout * gtk_entry_create_layout (GtkEntry *entry, gboolean include_preedit) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); PangoLayout *layout = gtk_widget_create_pango_layout (widget, NULL); PangoAttrList *tmp_attrs = pango_attr_list_new (); gboolean placeholder_layout = show_placeholder_text (entry); gchar *preedit_string = NULL; gint preedit_length = 0; PangoAttrList *preedit_attrs = NULL; gchar *display; guint n_bytes; pango_layout_set_single_paragraph_mode (layout, TRUE); display = placeholder_layout ? g_strdup (priv->placeholder_text) : gtk_entry_get_display_text (entry, 0, -1); n_bytes = strlen (display); if (!placeholder_layout && include_preedit) { gtk_im_context_get_preedit_string (priv->im_context, &preedit_string, &preedit_attrs, NULL); preedit_length = priv->preedit_length; } else if (placeholder_layout) { PangoColor color; PangoAttribute *attr; gtk_entry_get_placeholder_text_color (entry, &color); attr = pango_attr_foreground_new (color.red, color.green, color.blue); attr->start_index = 0; attr->end_index = G_MAXINT; pango_attr_list_insert (tmp_attrs, attr); } if (preedit_length) { GString *tmp_string = g_string_new (display); gint cursor_index = g_utf8_offset_to_pointer (display, priv->current_pos) - display; g_string_insert (tmp_string, cursor_index, preedit_string); 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 (gtk_entry_get_display_mode (entry) == DISPLAY_NORMAL) pango_dir = pango_find_base_dir (display, 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); priv->resolved_dir = pango_dir; pango_layout_set_text (layout, display, n_bytes); } pango_layout_set_attributes (layout, tmp_attrs); g_free (preedit_string); g_free (display); 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) { GtkEntryPrivate *priv = entry->priv; if (priv->preedit_length > 0 && !include_preedit != !priv->cache_includes_preedit) gtk_entry_reset_layout (entry); if (!priv->cached_layout) { priv->cached_layout = gtk_entry_create_layout (entry, include_preedit); priv->cache_includes_preedit = include_preedit; } return priv->cached_layout; } static void get_layout_position (GtkEntry *entry, gint *x, gint *y) { GtkEntryPrivate *priv = entry->priv; PangoLayout *layout; PangoRectangle logical_rect; gint area_width, area_height; gint y_pos; PangoLayoutLine *line; layout = gtk_entry_ensure_layout (entry, TRUE); gtk_entry_get_text_area_size (entry, NULL, NULL, &area_width, &area_height); area_height = PANGO_SCALE * area_height; 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 - priv->ascent - priv->descent) / 2 + priv->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 = y_pos / PANGO_SCALE; if (x) *x = - priv->scroll_offset; if (y) *y = y_pos; } static void draw_text_with_color (GtkEntry *entry, cairo_t *cr, GdkRGBA *default_color) { GtkEntryPrivate *priv = entry->priv; PangoLayout *layout = gtk_entry_ensure_layout (entry, TRUE); GtkWidget *widget; gint x, y; gint start_pos, end_pos; widget = GTK_WIDGET (entry); cairo_save (cr); get_layout_position (entry, &x, &y); cairo_move_to (cr, x, y); gdk_cairo_set_source_rgba (cr, default_color); 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; GdkRGBA selection_color, text_color; GtkStyleContext *context; GtkStateFlags state; context = gtk_widget_get_style_context (widget); pango_layout_get_pixel_extents (layout, NULL, &logical_rect); gtk_entry_get_pixel_ranges (entry, &ranges, &n_ranges); state = gtk_widget_get_state_flags (widget); state |= GTK_STATE_FLAG_SELECTED; gtk_style_context_get_background_color (context, state, &selection_color); gtk_style_context_get_color (context, state, &text_color); for (i = 0; i < n_ranges; ++i) cairo_rectangle (cr, - priv->scroll_offset + ranges[2 * i], y, ranges[2 * i + 1], logical_rect.height); cairo_clip (cr); gdk_cairo_set_source_rgba (cr, &selection_color); cairo_paint (cr); cairo_move_to (cr, x, y); gdk_cairo_set_source_rgba (cr, &text_color); pango_cairo_show_layout (cr, layout); g_free (ranges); } cairo_restore (cr); } static void gtk_entry_draw_text (GtkEntry *entry, cairo_t *cr) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); GtkStateFlags state = 0; GdkRGBA text_color, bar_text_color; GtkStyleContext *context; gint width, height; gint progress_x, progress_y, progress_width, progress_height; gint clip_width, clip_height; /* Nothing to display at all */ if (gtk_entry_get_display_mode (entry) == DISPLAY_BLANK) return; state = gtk_widget_get_state_flags (widget); context = gtk_widget_get_style_context (widget); gtk_style_context_get_color (context, state, &text_color); /* Get foreground color for progressbars */ gtk_entry_prepare_context_for_progress (entry, context); gtk_style_context_get_color (context, state, &bar_text_color); gtk_style_context_restore (context); get_progress_area (widget, &progress_x, &progress_y, &progress_width, &progress_height); cairo_save (cr); clip_width = gdk_window_get_width (priv->text_area); clip_height = gdk_window_get_height (priv->text_area); cairo_rectangle (cr, 0, 0, clip_width, clip_height); cairo_clip (cr); /* If the color is the same, or the progress area has a zero * size, then we only need to draw once. */ if (gdk_rgba_equal (&text_color, &bar_text_color) || ((progress_width == 0) || (progress_height == 0))) { draw_text_with_color (entry, cr, &text_color); } else { int frame_x, frame_y, area_x, area_y; width = gdk_window_get_width (priv->text_area); height = gdk_window_get_height (priv->text_area); cairo_save (cr); cairo_set_fill_rule (cr, CAIRO_FILL_RULE_EVEN_ODD); cairo_rectangle (cr, 0, 0, width, height); /* progres area is frame-relative, we need it text-area window * relative */ get_frame_size (entry, TRUE, &frame_x, &frame_y, NULL, NULL); gdk_window_get_position (priv->text_area, &area_x, &area_y); progress_x += frame_x - area_x; progress_y += frame_y - area_y; cairo_rectangle (cr, progress_x, progress_y, progress_width, progress_height); cairo_clip (cr); cairo_set_fill_rule (cr, CAIRO_FILL_RULE_WINDING); draw_text_with_color (entry, cr, &text_color); cairo_restore (cr); cairo_save (cr); cairo_rectangle (cr, progress_x, progress_y, progress_width, progress_height); cairo_clip (cr); draw_text_with_color (entry, cr, &bar_text_color); cairo_restore (cr); } cairo_restore (cr); } static void gtk_entry_draw_cursor (GtkEntry *entry, cairo_t *cr, CursorType type) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); GtkStyleContext *context; PangoRectangle cursor_rect; gint cursor_index; gboolean block; gboolean block_at_line_end; PangoLayout *layout; const char *text; context = gtk_widget_get_style_context (widget); layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, priv->current_pos + priv->preedit_cursor) - text; if (!priv->overwrite_mode) block = FALSE; else block = _gtk_text_util_get_block_cursor_location (layout, cursor_index, &cursor_rect, &block_at_line_end); if (!block) { gtk_render_insertion_cursor (context, cr, - priv->scroll_offset, 0, layout, cursor_index, priv->resolved_dir); } else /* overwrite_mode */ { GdkRGBA cursor_color; GdkRectangle rect; gint x, y; cairo_save (cr); 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); _gtk_style_context_get_cursor_color (context, &cursor_color, NULL); gdk_cairo_set_source_rgba (cr, &cursor_color); gdk_cairo_rectangle (cr, &rect); cairo_fill (cr); if (!block_at_line_end) { GtkStateFlags state; GdkRGBA color; state = gtk_widget_get_state_flags (widget); gtk_style_context_get_background_color (context, state, &color); gdk_cairo_rectangle (cr, &rect); cairo_clip (cr); cairo_move_to (cr, x, y); gdk_cairo_set_source_rgba (cr, &color); pango_cairo_show_layout (cr, layout); } cairo_restore (cr); } } void _gtk_entry_reset_im_context (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->need_im_reset) { priv->need_im_reset = FALSE; gtk_im_context_reset (priv->im_context); } } /** * gtk_entry_reset_im_context: * @entry: a #GtkEntry * * Reset the input method context of the entry if needed. * * This can be necessary in the case where modifying the buffer * would confuse on-going input method behavior. * * Since: 2.22 */ void gtk_entry_reset_im_context (GtkEntry *entry) { g_return_if_fail (GTK_IS_ENTRY (entry)); _gtk_entry_reset_im_context (entry); } /** * gtk_entry_im_context_filter_keypress: * @entry: a #GtkEntry * @event: (type Gdk.EventKey): the key event * * Allow the #GtkEntry input method to internally handle key press * and release events. If this function returns %TRUE, then no further * processing should be done for this key event. See * gtk_im_context_filter_keypress(). * * Note that you are expected to call this function from your handler * when overriding key event handling. This is needed in the case when * you need to insert your own key handling between the input method * and the default key event handling of the #GtkEntry. * See gtk_text_view_reset_im_context() for an example of use. * * Return value: %TRUE if the input method handled the key event. * * Since: 2.22 */ gboolean gtk_entry_im_context_filter_keypress (GtkEntry *entry, GdkEventKey *event) { GtkEntryPrivate *priv; g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); priv = entry->priv; return gtk_im_context_filter_keypress (priv->im_context, event); } GtkIMContext* _gtk_entry_get_im_context (GtkEntry *entry) { return entry->priv->im_context; } static gint gtk_entry_find_position (GtkEntry *entry, gint x) { GtkEntryPrivate *priv = entry->priv; 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, priv->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 && priv->preedit_length) { if (index >= cursor_index + priv->preedit_length) index -= priv->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) { GtkEntryPrivate *priv = entry->priv; DisplayMode mode = gtk_entry_get_display_mode (entry); /* Nothing to display at all, so no cursor is relevant */ if (mode == DISPLAY_BLANK) { 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, priv->current_pos + priv->preedit_cursor) - text; } else /* type == CURSOR_DND */ { index = g_utf8_offset_to_pointer (text, priv->dnd_position) - text; if (priv->dnd_position > priv->current_pos) { if (mode == DISPLAY_NORMAL) index += priv->preedit_length; else { gint preedit_len_chars = g_utf8_strlen (text, -1) - gtk_entry_buffer_get_length (get_buffer (entry)); index += preedit_len_chars * g_unichar_to_utf8 (priv->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 = entry->priv; gint min_offset, max_offset; gint text_area_width, text_width; gint strong_x, weak_x; gint strong_xoffset, weak_xoffset; gfloat xalign; PangoLayout *layout; PangoLayoutLine *line; PangoRectangle logical_rect; if (!gtk_widget_get_realized (GTK_WIDGET (entry))) return; text_area_width = gdk_window_get_width (priv->text_area); 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 (priv->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; } priv->scroll_offset = CLAMP (priv->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 - priv->scroll_offset; if (strong_xoffset < 0) { priv->scroll_offset += strong_xoffset; strong_xoffset = 0; } else if (strong_xoffset > text_area_width) { priv->scroll_offset += strong_xoffset - text_area_width; strong_xoffset = text_area_width; } weak_xoffset = weak_x - priv->scroll_offset; if (weak_xoffset < 0 && strong_xoffset - weak_xoffset <= text_area_width) { priv->scroll_offset += weak_xoffset; } else if (weak_xoffset > text_area_width && strong_xoffset - (weak_xoffset - text_area_width) >= 0) { priv->scroll_offset += weak_xoffset - text_area_width; } g_object_notify (G_OBJECT (entry), "scroll-offset"); } static void gtk_entry_move_adjustments (GtkEntry *entry) { GtkWidget *widget = GTK_WIDGET (entry); GtkAllocation allocation; GtkAdjustment *adjustment; PangoContext *context; PangoFontMetrics *metrics; GtkStyleContext *style_context; GtkStateFlags state; GtkBorder borders; gint x, layout_x; gint char_width; adjustment = g_object_get_qdata (G_OBJECT (entry), quark_cursor_hadjustment); if (!adjustment) return; gtk_widget_get_allocation (widget, &allocation); /* 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, &borders); x += allocation.x + layout_x + borders.left; /* Approximate width of a char, so user can see what is ahead/behind */ context = gtk_widget_get_pango_context (widget); style_context = gtk_widget_get_style_context (widget); state = gtk_widget_get_state_flags (widget); metrics = pango_context_get_metrics (context, gtk_style_context_get_font (style_context, state), 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) { GtkEntryPrivate *priv = entry->priv; 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 == priv->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; guint length; length = gtk_entry_buffer_get_length (get_buffer (entry)); /* Prevent any leak of information */ if (gtk_entry_get_display_mode (entry) != DISPLAY_NORMAL) { new_pos = CLAMP (start + count, 0, length); } else { 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 < length) { do new_pos++; while (new_pos < 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; guint length; length = gtk_entry_buffer_get_length (get_buffer (entry)); /* Prevent any leak of information */ if (gtk_entry_get_display_mode (entry) != DISPLAY_NORMAL) { new_pos = length; } else if (new_pos < 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 (gtk_entry_get_display_mode (entry) != DISPLAY_NORMAL) { new_pos = 0; } else if (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) { GtkEntryPrivate *priv = entry->priv; 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 = priv->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) { GtkEntryPrivate *priv = entry->priv; gint start_pos = gtk_entry_move_backward_word (entry, priv->current_pos, TRUE); gint end_pos = gtk_entry_move_forward_word (entry, priv->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); } 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 = entry->priv; if (priv->button == GDK_BUTTON_MIDDLE) { 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 (priv->truncate_multiline) length = truncate_multiline (text); /* only complete if the selection is at the end */ popup_completion = (gtk_entry_buffer_get_length (get_buffer (entry)) == MAX (priv->current_pos, priv->selection_bound)); if (completion) { if (gtk_widget_get_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); if (gtk_editable_get_selection_bounds (editable, &start, &end)) gtk_editable_delete_text (editable, start, end); pos = priv->current_pos; gtk_editable_insert_text (editable, text, length, &pos); gtk_editable_set_position (editable, pos); 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_display_text (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); GtkEntryPrivate *priv = entry->priv; gtk_editable_select_region (GTK_EDITABLE (entry), priv->current_pos, priv->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_get_realized (GTK_WIDGET (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); } static void gtk_entry_clear (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; GtkImageType storage_type; if (icon_info && _gtk_icon_helper_get_is_empty (icon_info->icon_helper)) return; g_object_freeze_notify (G_OBJECT (entry)); /* Explicitly check, as the pointer may become invalidated * during destruction. */ if (GDK_IS_WINDOW (icon_info->window)) gdk_window_hide (icon_info->window); storage_type = _gtk_icon_helper_get_storage_type (icon_info->icon_helper); switch (storage_type) { case GTK_IMAGE_PIXBUF: g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-pixbuf" : "secondary-icon-pixbuf"); break; case GTK_IMAGE_STOCK: g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-stock" : "secondary-icon-stock"); break; case GTK_IMAGE_ICON_NAME: g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-name" : "secondary-icon-name"); break; case GTK_IMAGE_GICON: g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-gicon" : "secondary-icon-gicon"); break; default: g_assert_not_reached (); break; } _gtk_icon_helper_clear (icon_info->icon_helper); g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-storage-type" : "secondary-icon-storage-type"); g_object_thaw_notify (G_OBJECT (entry)); } static GdkPixbuf * gtk_entry_ensure_pixbuf (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv = entry->priv; EntryIconInfo *icon_info = priv->icons[icon_pos]; GtkStyleContext *context; GdkPixbuf *pix; context = gtk_widget_get_style_context (GTK_WIDGET (entry)); gtk_entry_prepare_context_for_icon (entry, context, icon_pos); pix = _gtk_icon_helper_ensure_pixbuf (icon_info->icon_helper, context); gtk_style_context_restore (context); return pix; } /* 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_buffer: * @buffer: The buffer to use for the new #GtkEntry. * * Creates a new entry with the specified text buffer. * * Return value: a new #GtkEntry * * Since: 2.18 */ GtkWidget* gtk_entry_new_with_buffer (GtkEntryBuffer *buffer) { g_return_val_if_fail (GTK_IS_ENTRY_BUFFER (buffer), NULL); return g_object_new (GTK_TYPE_ENTRY, "buffer", buffer, NULL); } static GtkEntryBuffer* get_buffer (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->buffer == NULL) { GtkEntryBuffer *buffer; buffer = gtk_entry_buffer_new (NULL, 0); gtk_entry_set_buffer (entry, buffer); g_object_unref (buffer); } return priv->buffer; } /** * gtk_entry_get_buffer: * @entry: a #GtkEntry * * Get the #GtkEntryBuffer object which holds the text for * this widget. * * Since: 2.18 * * Returns: (transfer none): A #GtkEntryBuffer object. */ GtkEntryBuffer* gtk_entry_get_buffer (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return get_buffer (entry); } /** * gtk_entry_set_buffer: * @entry: a #GtkEntry * @buffer: a #GtkEntryBuffer * * Set the #GtkEntryBuffer object which holds the text for * this widget. * * Since: 2.18 */ void gtk_entry_set_buffer (GtkEntry *entry, GtkEntryBuffer *buffer) { GtkEntryPrivate *priv; GObject *obj; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; if (buffer) { g_return_if_fail (GTK_IS_ENTRY_BUFFER (buffer)); g_object_ref (buffer); } if (priv->buffer) { buffer_disconnect_signals (entry); g_object_unref (priv->buffer); } priv->buffer = buffer; if (priv->buffer) buffer_connect_signals (entry); obj = G_OBJECT (entry); g_object_freeze_notify (obj); g_object_notify (obj, "buffer"); g_object_notify (obj, "text"); g_object_notify (obj, "text-length"); g_object_notify (obj, "max-length"); g_object_notify (obj, "visibility"); g_object_notify (obj, "invisible-char"); g_object_notify (obj, "invisible-char-set"); g_object_thaw_notify (obj); gtk_editable_set_position (GTK_EDITABLE (entry), 0); gtk_entry_recompute (entry); } /** * gtk_entry_get_text_area: * @entry: a #GtkEntry * @text_area: (out): Return location for the text area. * * Gets the area where the entry's text is drawn. This function is * useful when drawing something to the entry in a draw callback. * * If the entry is not realized, @text_area is filled with zeros. * * See also gtk_entry_get_icon_area(). * * Since: 3.0 **/ void gtk_entry_get_text_area (GtkEntry *entry, GdkRectangle *text_area) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (text_area != NULL); priv = entry->priv; if (priv->text_area) { GtkAllocation allocation; gint x, y; gtk_widget_get_allocation (GTK_WIDGET (entry), &allocation); gdk_window_get_position (priv->text_area, &x, &y); text_area->x = x - allocation.x; text_area->y = y - allocation.y; text_area->width = gdk_window_get_width (priv->text_area); text_area->height = gdk_window_get_height (priv->text_area); } else { text_area->x = 0; text_area->y = 0; text_area->width = 0; text_area->height = 0; } } /** * 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. * * See gtk_entry_buffer_set_text(). */ 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 (gtk_entry_buffer_get_text (get_buffer (entry)), 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); gtk_editable_delete_text (GTK_EDITABLE (entry), 0, -1); tmp_pos = 0; gtk_editable_insert_text (GTK_EDITABLE (entry), text, strlen (text), &tmp_pos); end_change (entry); if (completion && completion->priv->changed_id > 0) g_signal_handler_unblock (entry, completion->priv->changed_id); } /** * 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. * * By default, GTK+ picks the best invisible character available * in the current font, but it can be changed with * gtk_entry_set_invisible_char(). */ void gtk_entry_set_visibility (GtkEntry *entry, gboolean visible) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; visible = visible != FALSE; if (priv->visible != visible) { priv->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->priv->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. By default, GTK+ * picks the best invisible char available in the current font. 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) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; if (!priv->invisible_char_set) { priv->invisible_char_set = TRUE; g_object_notify (G_OBJECT (entry), "invisible-char-set"); } if (ch == priv->invisible_char) return; priv->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->priv->invisible_char; } /** * gtk_entry_unset_invisible_char: * @entry: a #GtkEntry * * Unsets the invisible char previously set with * gtk_entry_set_invisible_char(). So that the * default invisible char is used again. * * Since: 2.16 **/ void gtk_entry_unset_invisible_char (GtkEntry *entry) { GtkEntryPrivate *priv; gunichar ch; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; if (!priv->invisible_char_set) return; priv->invisible_char_set = FALSE; ch = find_invisible_char (GTK_WIDGET (entry)); if (priv->invisible_char != ch) { priv->invisible_char = ch; g_object_notify (G_OBJECT (entry), "invisible-char"); } g_object_notify (G_OBJECT (entry), "invisible-char-set"); gtk_entry_recompute (entry); } /** * 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) { GtkEntryPrivate *priv = entry->priv; g_return_if_fail (GTK_IS_ENTRY (entry)); if (priv->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->priv->overwrite_mode; } /** * gtk_entry_get_text: * @entry: a #GtkEntry * * Retrieves the contents of the entry widget. * See also gtk_editable_get_chars(). * * This is equivalent to: * * * gtk_entry_buffer_get_text (gtk_entry_get_buffer (entry)); * * * 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. **/ const gchar* gtk_entry_get_text (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return gtk_entry_buffer_get_text (get_buffer (entry)); } /** * 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. * * This is equivalent to: * * * gtk_entry_buffer_set_max_length (gtk_entry_get_buffer (entry), max); * **/ void gtk_entry_set_max_length (GtkEntry *entry, gint max) { g_return_if_fail (GTK_IS_ENTRY (entry)); gtk_entry_buffer_set_max_length (get_buffer (entry), max); } /** * gtk_entry_get_max_length: * @entry: a #GtkEntry * * Retrieves the maximum allowed length of the text in * @entry. See gtk_entry_set_max_length(). * * This is equivalent to: * * * gtk_entry_buffer_get_max_length (gtk_entry_get_buffer (entry)); * * * 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 gtk_entry_buffer_get_max_length (get_buffer (entry)); } /** * gtk_entry_get_text_length: * @entry: a #GtkEntry * * Retrieves the current length of the text in * @entry. * * This is equivalent to: * * * gtk_entry_buffer_get_length (gtk_entry_get_buffer (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 gtk_entry_buffer_get_length (get_buffer (entry)); } /** * 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) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; setting = setting != FALSE; if (setting != priv->activates_default) { priv->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->priv->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) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; if (priv->width_chars != n_chars) { priv->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->priv->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) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; setting = (setting != FALSE); if (priv->has_frame == setting) return; gtk_widget_queue_resize (GTK_WIDGET (entry)); priv->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->priv->has_frame; } /** * gtk_entry_set_inner_border: * @entry: a #GtkEntry * @border: (allow-none): 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 * * Deprecated: 3.4: Use the standard border and padding CSS properties; * the value set with this function is ignored by #GtkEntry. **/ void gtk_entry_set_inner_border (GtkEntry *entry, const GtkBorder *border) { g_return_if_fail (GTK_IS_ENTRY (entry)); gtk_entry_do_set_inner_border (entry, 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: (transfer none): the entry's #GtkBorder, or %NULL if none was set. * * Since: 2.10 * * Deprecated: 3.4: Use the standard border and padding CSS properties; * the value returned by this function is ignored by #GtkEntry. **/ const GtkBorder * gtk_entry_get_inner_border (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); return gtk_entry_do_get_inner_border (entry); } /** * 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: (transfer none): 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) { GtkEntryPrivate *priv; PangoLayout *layout; const gchar *text; gint cursor_index; g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); priv = entry->priv; layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, priv->current_pos) - text; if (layout_index >= cursor_index && priv->preedit_length) { if (layout_index >= cursor_index + priv->preedit_length) layout_index -= priv->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) { GtkEntryPrivate *priv; PangoLayout *layout; const gchar *text; gint cursor_index; g_return_val_if_fail (GTK_IS_ENTRY (entry), 0); priv = entry->priv; layout = gtk_entry_ensure_layout (entry, TRUE); text = pango_layout_get_text (layout); cursor_index = g_utf8_offset_to_pointer (text, priv->current_pos) - text; if (text_index > cursor_index) text_index += priv->preedit_length; return text_index; } /** * gtk_entry_get_layout_offsets: * @entry: a #GtkEntry * @x: (out) (allow-none): location to store X offset of layout, or %NULL * @y: (out) (allow-none): 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 */ gtk_entry_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 = entry->priv; 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) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0.0); return entry->priv->xalign; } /** * gtk_entry_set_icon_from_pixbuf: * @entry: a #GtkEntry * @icon_pos: Icon position * @pixbuf: (allow-none): A #GdkPixbuf, or %NULL * * Sets the icon shown in the specified position using a pixbuf. * * If @pixbuf is %NULL, no icon will be shown in the specified position. * * Since: 2.16 */ void gtk_entry_set_icon_from_pixbuf (GtkEntry *entry, GtkEntryIconPosition icon_pos, GdkPixbuf *pixbuf) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); g_object_freeze_notify (G_OBJECT (entry)); if (pixbuf) g_object_ref (pixbuf); gtk_entry_clear (entry, icon_pos); if (pixbuf) { _gtk_icon_helper_set_pixbuf (icon_info->icon_helper, pixbuf); if (icon_pos == GTK_ENTRY_ICON_PRIMARY) { g_object_notify (G_OBJECT (entry), "primary-icon-pixbuf"); g_object_notify (G_OBJECT (entry), "primary-icon-storage-type"); } else { g_object_notify (G_OBJECT (entry), "secondary-icon-pixbuf"); g_object_notify (G_OBJECT (entry), "secondary-icon-storage-type"); } if (gtk_widget_get_mapped (GTK_WIDGET (entry))) gdk_window_show_unraised (icon_info->window); g_object_unref (pixbuf); } if (gtk_widget_get_visible (GTK_WIDGET (entry))) gtk_widget_queue_resize (GTK_WIDGET (entry)); g_object_thaw_notify (G_OBJECT (entry)); } /** * gtk_entry_set_icon_from_stock: * @entry: A #GtkEntry * @icon_pos: Icon position * @stock_id: (allow-none): The name of the stock item, or %NULL * * Sets the icon shown in the entry at the specified position from * a stock image. * * If @stock_id is %NULL, no icon will be shown in the specified position. * * Since: 2.16 */ void gtk_entry_set_icon_from_stock (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *stock_id) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; gchar *new_id; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); g_object_freeze_notify (G_OBJECT (entry)); /* need to dup before clearing */ new_id = g_strdup (stock_id); gtk_entry_clear (entry, icon_pos); if (new_id != NULL) { _gtk_icon_helper_set_stock_id (icon_info->icon_helper, new_id, GTK_ICON_SIZE_MENU); if (icon_pos == GTK_ENTRY_ICON_PRIMARY) { g_object_notify (G_OBJECT (entry), "primary-icon-stock"); g_object_notify (G_OBJECT (entry), "primary-icon-storage-type"); } else { g_object_notify (G_OBJECT (entry), "secondary-icon-stock"); g_object_notify (G_OBJECT (entry), "secondary-icon-storage-type"); } if (gtk_widget_get_mapped (GTK_WIDGET (entry))) gdk_window_show_unraised (icon_info->window); g_free (new_id); } if (gtk_widget_get_visible (GTK_WIDGET (entry))) gtk_widget_queue_resize (GTK_WIDGET (entry)); g_object_thaw_notify (G_OBJECT (entry)); } /** * gtk_entry_set_icon_from_icon_name: * @entry: A #GtkEntry * @icon_pos: The position at which to set the icon * @icon_name: (allow-none): An icon name, or %NULL * * Sets the icon shown in the entry at the specified position * from the current icon theme. * * If the icon name isn't known, a "broken image" icon will be displayed * instead. * * If @icon_name is %NULL, no icon will be shown in the specified position. * * Since: 2.16 */ void gtk_entry_set_icon_from_icon_name (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *icon_name) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; gchar *new_name; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); g_object_freeze_notify (G_OBJECT (entry)); /* need to dup before clearing */ new_name = g_strdup (icon_name); gtk_entry_clear (entry, icon_pos); if (new_name != NULL) { _gtk_icon_helper_set_icon_name (icon_info->icon_helper, new_name, GTK_ICON_SIZE_MENU); if (icon_pos == GTK_ENTRY_ICON_PRIMARY) { g_object_notify (G_OBJECT (entry), "primary-icon-name"); g_object_notify (G_OBJECT (entry), "primary-icon-storage-type"); } else { g_object_notify (G_OBJECT (entry), "secondary-icon-name"); g_object_notify (G_OBJECT (entry), "secondary-icon-storage-type"); } if (gtk_widget_get_mapped (GTK_WIDGET (entry))) gdk_window_show_unraised (icon_info->window); g_free (new_name); } if (gtk_widget_get_visible (GTK_WIDGET (entry))) gtk_widget_queue_resize (GTK_WIDGET (entry)); g_object_thaw_notify (G_OBJECT (entry)); } /** * gtk_entry_set_icon_from_gicon: * @entry: A #GtkEntry * @icon_pos: The position at which to set the icon * @icon: (allow-none): The icon to set, or %NULL * * Sets the icon shown in the entry at the specified position * from the current icon theme. * If the icon isn't known, a "broken image" icon will be displayed * instead. * * If @icon is %NULL, no icon will be shown in the specified position. * * Since: 2.16 */ void gtk_entry_set_icon_from_gicon (GtkEntry *entry, GtkEntryIconPosition icon_pos, GIcon *icon) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); g_object_freeze_notify (G_OBJECT (entry)); /* need to ref before clearing */ if (icon) g_object_ref (icon); gtk_entry_clear (entry, icon_pos); if (icon) { _gtk_icon_helper_set_gicon (icon_info->icon_helper, icon, GTK_ICON_SIZE_MENU); if (icon_pos == GTK_ENTRY_ICON_PRIMARY) { g_object_notify (G_OBJECT (entry), "primary-icon-gicon"); g_object_notify (G_OBJECT (entry), "primary-icon-storage-type"); } else { g_object_notify (G_OBJECT (entry), "secondary-icon-gicon"); g_object_notify (G_OBJECT (entry), "secondary-icon-storage-type"); } if (gtk_widget_get_mapped (GTK_WIDGET (entry))) gdk_window_show_unraised (icon_info->window); g_object_unref (icon); } if (gtk_widget_get_visible (GTK_WIDGET (entry))) gtk_widget_queue_resize (GTK_WIDGET (entry)); g_object_thaw_notify (G_OBJECT (entry)); } /** * gtk_entry_set_icon_activatable: * @entry: A #GtkEntry * @icon_pos: Icon position * @activatable: %TRUE if the icon should be activatable * * Sets whether the icon is activatable. * * Since: 2.16 */ void gtk_entry_set_icon_activatable (GtkEntry *entry, GtkEntryIconPosition icon_pos, gboolean activatable) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); activatable = activatable != FALSE; if (icon_info->nonactivatable != !activatable) { icon_info->nonactivatable = !activatable; if (gtk_widget_get_realized (GTK_WIDGET (entry))) update_cursors (GTK_WIDGET (entry)); g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-activatable" : "secondary-icon-activatable"); } } /** * gtk_entry_get_icon_activatable: * @entry: a #GtkEntry * @icon_pos: Icon position * * Returns whether the icon is activatable. * * Returns: %TRUE if the icon is activatable. * * Since: 2.16 */ gboolean gtk_entry_get_icon_activatable (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), FALSE); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), FALSE); priv = entry->priv; icon_info = priv->icons[icon_pos]; return (!icon_info || !icon_info->nonactivatable); } /** * gtk_entry_get_icon_pixbuf: * @entry: A #GtkEntry * @icon_pos: Icon position * * Retrieves the image used for the icon. * * Unlike the other methods of setting and getting icon data, this * method will work regardless of whether the icon was set using a * #GdkPixbuf, a #GIcon, a stock item, or an icon name. * * Returns: (transfer none): A #GdkPixbuf, or %NULL if no icon is * set for this position. * * Since: 2.16 */ GdkPixbuf * gtk_entry_get_icon_pixbuf (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; GdkPixbuf *pixbuf; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; /* HACK: unfortunately this is transfer none, so we need to return * the icon helper's cache ref directly. */ pixbuf = gtk_entry_ensure_pixbuf (entry, icon_pos); g_object_unref (pixbuf); return pixbuf; } /** * gtk_entry_get_icon_gicon: * @entry: A #GtkEntry * @icon_pos: Icon position * * Retrieves the #GIcon used for the icon, or %NULL if there is * no icon or if the icon was set by some other method (e.g., by * stock, pixbuf, or icon name). * * Returns: (transfer none): A #GIcon, or %NULL if no icon is set * or if the icon is not a #GIcon * * Since: 2.16 */ GIcon * gtk_entry_get_icon_gicon (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; return _gtk_icon_helper_peek_gicon (icon_info->icon_helper); } /** * gtk_entry_get_icon_stock: * @entry: A #GtkEntry * @icon_pos: Icon position * * Retrieves the stock id used for the icon, or %NULL if there is * no icon or if the icon was set by some other method (e.g., by * pixbuf, icon name or gicon). * * Returns: A stock id, or %NULL if no icon is set or if the icon * wasn't set from a stock id * * Since: 2.16 */ const gchar * gtk_entry_get_icon_stock (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; return _gtk_icon_helper_get_stock_id (icon_info->icon_helper); } /** * gtk_entry_get_icon_name: * @entry: A #GtkEntry * @icon_pos: Icon position * * Retrieves the icon name used for the icon, or %NULL if there is * no icon or if the icon was set by some other method (e.g., by * pixbuf, stock or gicon). * * Returns: An icon name, or %NULL if no icon is set or if the icon * wasn't set from an icon name * * Since: 2.16 */ const gchar * gtk_entry_get_icon_name (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; return _gtk_icon_helper_get_icon_name (icon_info->icon_helper); } /** * gtk_entry_set_icon_sensitive: * @entry: A #GtkEntry * @icon_pos: Icon position * @sensitive: Specifies whether the icon should appear * sensitive or insensitive * * Sets the sensitivity for the specified icon. * * Since: 2.16 */ void gtk_entry_set_icon_sensitive (GtkEntry *entry, GtkEntryIconPosition icon_pos, gboolean sensitive) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); if (icon_info->insensitive != !sensitive) { icon_info->insensitive = !sensitive; icon_info->pressed = FALSE; icon_info->prelight = FALSE; if (gtk_widget_get_realized (GTK_WIDGET (entry))) update_cursors (GTK_WIDGET (entry)); gtk_widget_queue_draw (GTK_WIDGET (entry)); g_object_notify (G_OBJECT (entry), icon_pos == GTK_ENTRY_ICON_PRIMARY ? "primary-icon-sensitive" : "secondary-icon-sensitive"); } } /** * gtk_entry_get_icon_sensitive: * @entry: a #GtkEntry * @icon_pos: Icon position * * Returns whether the icon appears sensitive or insensitive. * * Returns: %TRUE if the icon is sensitive. * * Since: 2.16 */ gboolean gtk_entry_get_icon_sensitive (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), TRUE); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), TRUE); priv = entry->priv; icon_info = priv->icons[icon_pos]; return (!icon_info || !icon_info->insensitive); } /** * gtk_entry_get_icon_storage_type: * @entry: a #GtkEntry * @icon_pos: Icon position * * Gets the type of representation being used by the icon * to store image data. If the icon has no image data, * the return value will be %GTK_IMAGE_EMPTY. * * Return value: image representation being used * * Since: 2.16 **/ GtkImageType gtk_entry_get_icon_storage_type (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), GTK_IMAGE_EMPTY); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), GTK_IMAGE_EMPTY); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return GTK_IMAGE_EMPTY; return _gtk_icon_helper_get_storage_type (icon_info->icon_helper); } /** * gtk_entry_get_icon_at_pos: * @entry: a #GtkEntry * @x: the x coordinate of the position to find * @y: the y coordinate of the position to find * * Finds the icon at the given position and return its index. The * position's coordinates are relative to the @entry's top left corner. * If @x, @y doesn't lie inside an icon, -1 is returned. * This function is intended for use in a #GtkWidget::query-tooltip * signal handler. * * Returns: the index of the icon at the given position, or -1 * * Since: 2.16 */ gint gtk_entry_get_icon_at_pos (GtkEntry *entry, gint x, gint y) { GtkAllocation primary; GtkAllocation secondary; gint frame_x, frame_y; g_return_val_if_fail (GTK_IS_ENTRY (entry), -1); get_frame_size (entry, FALSE, &frame_x, &frame_y, NULL, NULL); x -= frame_x; y -= frame_y; get_icon_allocations (entry, &primary, &secondary); if (primary.x <= x && x < primary.x + primary.width && primary.y <= y && y < primary.y + primary.height) return GTK_ENTRY_ICON_PRIMARY; if (secondary.x <= x && x < secondary.x + secondary.width && secondary.y <= y && y < secondary.y + secondary.height) return GTK_ENTRY_ICON_SECONDARY; return -1; } /** * gtk_entry_set_icon_drag_source: * @entry: a #GtkIconEntry * @icon_pos: icon position * @target_list: the targets (data formats) in which the data can be provided * @actions: a bitmask of the allowed drag actions * * Sets up the icon at the given position so that GTK+ will start a drag * operation when the user clicks and drags the icon. * * To handle the drag operation, you need to connect to the usual * #GtkWidget::drag-data-get (or possibly #GtkWidget::drag-data-delete) * signal, and use gtk_entry_get_current_icon_drag_source() in * your signal handler to find out if the drag was started from * an icon. * * By default, GTK+ uses the icon as the drag icon. You can use the * #GtkWidget::drag-begin signal to set a different icon. Note that you * have to use g_signal_connect_after() to ensure that your signal handler * gets executed after the default handler. * * Since: 2.16 */ void gtk_entry_set_icon_drag_source (GtkEntry *entry, GtkEntryIconPosition icon_pos, GtkTargetList *target_list, GdkDragAction actions) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); if (icon_info->target_list) gtk_target_list_unref (icon_info->target_list); icon_info->target_list = target_list; if (icon_info->target_list) gtk_target_list_ref (icon_info->target_list); icon_info->actions = actions; } /** * gtk_entry_get_current_icon_drag_source: * @entry: a #GtkIconEntry * * Returns the index of the icon which is the source of the current * DND operation, or -1. * * This function is meant to be used in a #GtkWidget::drag-data-get * callback. * * Returns: index of the icon which is the source of the current * DND operation, or -1. * * Since: 2.16 */ gint gtk_entry_get_current_icon_drag_source (GtkEntry *entry) { GtkEntryPrivate *priv; EntryIconInfo *icon_info = NULL; gint i; g_return_val_if_fail (GTK_IS_ENTRY (entry), -1); priv = entry->priv; for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i])) { if (icon_info->in_drag) return i; } } return -1; } /** * gtk_entry_get_icon_area: * @entry: A #GtkEntry * @icon_pos: Icon position * @icon_area: (out): Return location for the icon's area * * Gets the area where entry's icon at @icon_pos is drawn. * This function is useful when drawing something to the * entry in a draw callback. * * If the entry is not realized or has no icon at the given position, * @icon_area is filled with zeros. * * See also gtk_entry_get_text_area() * * Since: 3.0 */ void gtk_entry_get_icon_area (GtkEntry *entry, GtkEntryIconPosition icon_pos, GdkRectangle *icon_area) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (icon_area != NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (icon_info) { GtkAllocation primary; GtkAllocation secondary; get_icon_allocations (entry, &primary, &secondary); if (icon_pos == GTK_ENTRY_ICON_PRIMARY) *icon_area = primary; else *icon_area = secondary; } else { icon_area->x = 0; icon_area->y = 0; icon_area->width = 0; icon_area->height = 0; } } static void ensure_has_tooltip (GtkEntry *entry) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; int i; gboolean has_tooltip = FALSE; priv = entry->priv; for (i = 0; i < MAX_ICONS; i++) { if ((icon_info = priv->icons[i]) != NULL) { if (icon_info->tooltip != NULL) { has_tooltip = TRUE; break; } } } gtk_widget_set_has_tooltip (GTK_WIDGET (entry), has_tooltip); } /** * gtk_entry_get_icon_tooltip_text: * @entry: a #GtkEntry * @icon_pos: the icon position * * Gets the contents of the tooltip on the icon at the specified * position in @entry. * * Returns: the tooltip text, or %NULL. Free the returned string * with g_free() when done. * * Since: 2.16 */ gchar * gtk_entry_get_icon_tooltip_text (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; gchar *text = NULL; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; if (icon_info->tooltip && !pango_parse_markup (icon_info->tooltip, -1, 0, NULL, &text, NULL, NULL)) g_assert (NULL == text); /* text should still be NULL in case of markup errors */ return text; } /** * gtk_entry_set_icon_tooltip_text: * @entry: a #GtkEntry * @icon_pos: the icon position * @tooltip: (allow-none): the contents of the tooltip for the icon, or %NULL * * Sets @tooltip as the contents of the tooltip for the icon * at the specified position. * * Use %NULL for @tooltip to remove an existing tooltip. * * See also gtk_widget_set_tooltip_text() and * gtk_entry_set_icon_tooltip_markup(). * * Since: 2.16 */ void gtk_entry_set_icon_tooltip_text (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *tooltip) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); if (icon_info->tooltip) g_free (icon_info->tooltip); /* Treat an empty string as a NULL string, * because an empty string would be useless for a tooltip: */ if (tooltip && tooltip[0] == '\0') tooltip = NULL; icon_info->tooltip = tooltip ? g_markup_escape_text (tooltip, -1) : NULL; ensure_has_tooltip (entry); } /** * gtk_entry_get_icon_tooltip_markup: * @entry: a #GtkEntry * @icon_pos: the icon position * * Gets the contents of the tooltip on the icon at the specified * position in @entry. * * Returns: the tooltip text, or %NULL. Free the returned string * with g_free() when done. * * Since: 2.16 */ gchar * gtk_entry_get_icon_tooltip_markup (GtkEntry *entry, GtkEntryIconPosition icon_pos) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); g_return_val_if_fail (IS_VALID_ICON_POSITION (icon_pos), NULL); priv = entry->priv; icon_info = priv->icons[icon_pos]; if (!icon_info) return NULL; return g_strdup (icon_info->tooltip); } /** * gtk_entry_set_icon_tooltip_markup: * @entry: a #GtkEntry * @icon_pos: the icon position * @tooltip: (allow-none): the contents of the tooltip for the icon, or %NULL * * Sets @tooltip as the contents of the tooltip for the icon at * the specified position. @tooltip is assumed to be marked up with * the Pango text markup language. * * Use %NULL for @tooltip to remove an existing tooltip. * * See also gtk_widget_set_tooltip_markup() and * gtk_enty_set_icon_tooltip_text(). * * Since: 2.16 */ void gtk_entry_set_icon_tooltip_markup (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *tooltip) { GtkEntryPrivate *priv; EntryIconInfo *icon_info; g_return_if_fail (GTK_IS_ENTRY (entry)); g_return_if_fail (IS_VALID_ICON_POSITION (icon_pos)); priv = entry->priv; if ((icon_info = priv->icons[icon_pos]) == NULL) icon_info = construct_icon_info (GTK_WIDGET (entry), icon_pos); if (icon_info->tooltip) g_free (icon_info->tooltip); /* Treat an empty string as a NULL string, * because an empty string would be useless for a tooltip: */ if (tooltip && tooltip[0] == '\0') tooltip = NULL; icon_info->tooltip = g_strdup (tooltip); ensure_has_tooltip (entry); } static gboolean gtk_entry_query_tooltip (GtkWidget *widget, gint x, gint y, gboolean keyboard_tip, GtkTooltip *tooltip) { GtkEntry *entry; GtkEntryPrivate *priv; EntryIconInfo *icon_info; gint icon_pos; entry = GTK_ENTRY (widget); priv = entry->priv; if (!keyboard_tip) { icon_pos = gtk_entry_get_icon_at_pos (entry, x, y); if (icon_pos != -1) { if ((icon_info = priv->icons[icon_pos]) != NULL) { if (icon_info->tooltip) { gtk_tooltip_set_markup (tooltip, icon_info->tooltip); return TRUE; } return FALSE; } } } return GTK_WIDGET_CLASS (gtk_entry_parent_class)->query_tooltip (widget, x, y, keyboard_tip, tooltip); } /* 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) { GtkEntry *entry_attach = GTK_ENTRY (attach_widget); GtkEntryPrivate *priv_attach = entry_attach->priv; priv_attach->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); GtkEntryPrivate *priv = entry->priv; GtkWidget *widget = GTK_WIDGET (entry); GdkScreen *screen; GtkRequisition menu_req; GdkRectangle monitor; GtkBorder borders; gint monitor_num, strong_x, height; g_return_if_fail (gtk_widget_get_realized (widget)); gdk_window_get_origin (priv->text_area, x, y); screen = gtk_widget_get_screen (widget); monitor_num = gdk_screen_get_monitor_at_window (screen, priv->text_area); if (monitor_num < 0) monitor_num = 0; gtk_menu_set_monitor (menu, monitor_num); gdk_screen_get_monitor_workarea (screen, monitor_num, &monitor); gtk_widget_get_preferred_size (priv->popup_menu, &menu_req, NULL); height = gdk_window_get_height (priv->text_area); gtk_entry_get_cursor_locations (entry, CURSOR_STANDARD, &strong_x, NULL); _gtk_entry_get_borders (entry, &borders); *x += borders.left + strong_x - priv->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); GtkEntryPrivate *priv = entry->priv; if (priv->editable) gtk_entry_enter_text (entry, text); } typedef struct { GtkEntry *entry; gint button; guint time; GdkDevice *device; } PopupInfo; static void popup_targets_received (GtkClipboard *clipboard, GtkSelectionData *data, gpointer user_data) { PopupInfo *info = user_data; GtkEntry *entry = info->entry; GtkEntryPrivate *info_entry_priv = entry->priv; if (gtk_widget_get_realized (GTK_WIDGET (entry))) { DisplayMode mode; 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 (info_entry_priv->popup_menu) gtk_widget_destroy (info_entry_priv->popup_menu); info_entry_priv->popup_menu = gtk_menu_new (); gtk_menu_attach_to_widget (GTK_MENU (info_entry_priv->popup_menu), GTK_WIDGET (entry), popup_menu_detach); mode = gtk_entry_get_display_mode (entry); append_action_signal (entry, info_entry_priv->popup_menu, GTK_STOCK_CUT, "cut-clipboard", info_entry_priv->editable && mode == DISPLAY_NORMAL && info_entry_priv->current_pos != info_entry_priv->selection_bound); append_action_signal (entry, info_entry_priv->popup_menu, GTK_STOCK_COPY, "copy-clipboard", mode == DISPLAY_NORMAL && info_entry_priv->current_pos != info_entry_priv->selection_bound); append_action_signal (entry, info_entry_priv->popup_menu, GTK_STOCK_PASTE, "paste-clipboard", info_entry_priv->editable && clipboard_contains_text); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_DELETE, NULL); gtk_widget_set_sensitive (menuitem, info_entry_priv->editable && info_entry_priv->current_pos != info_entry_priv->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 (info_entry_priv->popup_menu), menuitem); menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (info_entry_priv->popup_menu), menuitem); menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_SELECT_ALL, NULL); gtk_widget_set_sensitive (menuitem, gtk_entry_buffer_get_length (info_entry_priv->buffer) > 0); g_signal_connect_swapped (menuitem, "activate", G_CALLBACK (gtk_entry_select_all), entry); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (info_entry_priv->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 (show_input_method_menu || show_unicode_menu) { menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (info_entry_priv->popup_menu), menuitem); } if (show_input_method_menu) { menuitem = gtk_menu_item_new_with_mnemonic (_("Input _Methods")); gtk_widget_set_sensitive (menuitem, info_entry_priv->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 (info_entry_priv->popup_menu), menuitem); gtk_im_multicontext_append_menuitems (GTK_IM_MULTICONTEXT (info_entry_priv->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, info_entry_priv->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 (info_entry_priv->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, info_entry_priv->popup_menu); if (info->device) gtk_menu_popup_for_device (GTK_MENU (info_entry_priv->popup_menu), info->device, NULL, NULL, NULL, NULL, NULL, info->button, info->time); else { gtk_menu_popup (GTK_MENU (info_entry_priv->popup_menu), NULL, NULL, popup_position_func, entry, 0, gtk_get_current_event_time ()); gtk_menu_shell_select_first (GTK_MENU_SHELL (info_entry_priv->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; info->device = event->device; } else { info->button = 0; info->time = gtk_get_current_event_time (); info->device = NULL; } 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_begin (GtkWidget *widget, GdkDragContext *context) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gint i; for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) { if (icon_info->in_drag) { GdkPixbuf *pix; pix = _gtk_icon_helper_ensure_pixbuf (icon_info->icon_helper, gtk_widget_get_style_context (GTK_WIDGET (entry))); gtk_drag_set_icon_pixbuf (context, pix, -2, -2); g_object_unref (pix); } } } } static void gtk_entry_drag_end (GtkWidget *widget, GdkDragContext *context) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; gint i; for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) icon_info->in_drag = 0; } } static void gtk_entry_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; priv->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); GtkEntryPrivate *priv = entry->priv; GdkAtom target = GDK_NONE; if (priv->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); GtkEntryPrivate *priv = entry->priv; GtkStyleContext *style_context; GtkWidget *source_widget; GdkDragAction suggested_action; gint new_position, old_position; gint sel1, sel2; GtkBorder padding; style_context = gtk_widget_get_style_context (widget); gtk_style_context_get_padding (style_context, 0, &padding); x -= padding.left; y -= padding.top; old_position = priv->dnd_position; new_position = gtk_entry_find_position (entry, x + priv->scroll_offset); if (priv->editable && gtk_drag_dest_find_target (widget, context, NULL) != GDK_NONE) { source_widget = gtk_drag_get_source_widget (context); suggested_action = gdk_drag_context_get_suggested_action (context); 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 ((gdk_drag_context_get_actions (context) & GDK_ACTION_MOVE) != 0) suggested_action = GDK_ACTION_MOVE; } priv->dnd_position = new_position; } else { if (source_widget == widget) suggested_action = 0; /* Can't drop in selection where drag started */ priv->dnd_position = -1; } } else { /* Entry not editable, or no text */ suggested_action = 0; priv->dnd_position = -1; } gdk_drag_status (context, suggested_action, time); if (priv->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); GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (widget); GtkStyleContext *style_context; GtkBorder padding; gchar *str; str = (gchar *) gtk_selection_data_get_text (selection_data); style_context = gtk_widget_get_style_context (widget); gtk_style_context_get_padding (style_context, 0, &padding); x -= padding.left; y -= padding.top; if (str && priv->editable) { gint new_position; gint sel1, sel2; gint length = -1; if (priv->truncate_multiline) length = truncate_multiline (str); new_position = gtk_entry_find_position (entry, x + priv->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); gtk_editable_delete_text (editable, sel1, sel2); gtk_editable_insert_text (editable, str, length, &sel1); end_change (entry); } gtk_drag_finish (context, TRUE, gdk_drag_context_get_selected_action (context) == 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) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (widget); gint sel_start, sel_end; gint i; /* If there is an icon drag going on, exit early. */ for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) { if (icon_info->in_drag) return; } } if (gtk_editable_get_selection_bounds (editable, &sel_start, &sel_end)) { gchar *str = gtk_entry_get_display_text (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) { GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; GtkEditable *editable = GTK_EDITABLE (widget); gint sel_start, sel_end; gint i; /* If there is an icon drag going on, exit early. */ for (i = 0; i < MAX_ICONS; i++) { EntryIconInfo *icon_info = priv->icons[i]; if (icon_info != NULL) { if (icon_info->in_drag) return; } } if (priv->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) { GtkEntryPrivate *priv = entry->priv; if (gtk_widget_has_focus (GTK_WIDGET (entry)) && priv->editable && priv->selection_bound == priv->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) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget; if (!priv->cursor_visible) { priv->cursor_visible = TRUE; widget = GTK_WIDGET (entry); if (gtk_widget_has_focus (widget) && priv->selection_bound == priv->current_pos) gtk_widget_queue_draw (widget); } } static void hide_cursor (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; GtkWidget *widget; if (priv->cursor_visible) { priv->cursor_visible = FALSE; widget = GTK_WIDGET (entry); if (gtk_widget_has_focus (widget) && priv->selection_bound == priv->current_pos) gtk_widget_queue_draw (widget); } } /* * Blink! */ static gint blink_cb (gpointer data) { GtkEntry *entry; GtkEntryPrivate *priv; gint blink_timeout; entry = GTK_ENTRY (data); priv = entry->priv; if (!gtk_widget_has_focus (GTK_WIDGET (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 (priv->selection_bound == priv->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); priv->blink_timeout = 0; } else if (priv->cursor_visible) { hide_cursor (entry); priv->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); priv->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 = entry->priv; if (cursor_blinks (entry)) { if (!priv->blink_timeout) { show_cursor (entry); priv->blink_timeout = gdk_threads_add_timeout (get_cursor_time (entry) * CURSOR_ON_MULTIPLIER / CURSOR_DIVIDER, blink_cb, entry); } } else { if (priv->blink_timeout) { g_source_remove (priv->blink_timeout); priv->blink_timeout = 0; } priv->cursor_visible = TRUE; } } static void gtk_entry_pend_cursor_blink (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (cursor_blinks (entry)) { if (priv->blink_timeout != 0) g_source_remove (priv->blink_timeout); priv->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 = entry->priv; priv->blink_time = 0; } /* completion */ static gint gtk_entry_completion_timeout (gpointer data) { GtkEntryCompletion *completion = GTK_ENTRY_COMPLETION (data); GtkEntryPrivate *completion_entry_priv = GTK_ENTRY (completion->priv->entry)->priv; 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_get_visible (completion->priv->popup_window)) _gtk_entry_completion_resize_popup (completion); else _gtk_entry_completion_popup (completion, completion_entry_priv->completion_device); } else _gtk_entry_completion_popdown (completion); } else if (gtk_widget_get_visible (completion->priv->popup_window)) _gtk_entry_completion_popdown (completion); return FALSE; } static inline gboolean keyval_is_cursor_move (guint keyval) { if (keyval == GDK_KEY_Up || keyval == GDK_KEY_KP_Up) return TRUE; if (keyval == GDK_KEY_Down || keyval == GDK_KEY_KP_Down) return TRUE; if (keyval == GDK_KEY_Page_Up) return TRUE; if (keyval == GDK_KEY_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_get_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_KEY_Up || event->keyval == GDK_KEY_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_KEY_Down || event->keyval == GDK_KEY_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_KEY_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 -= PAGE_STEP; if (completion->priv->current_selected < 0) completion->priv->current_selected = 0; } else { completion->priv->current_selected -= PAGE_STEP; if (completion->priv->current_selected < matches - 1) completion->priv->current_selected = matches - 1; } } else if (event->keyval == GDK_KEY_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 += PAGE_STEP; 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 += PAGE_STEP; 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; GtkTreeIter child_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; gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, &iter); model = gtk_tree_model_filter_get_model (GTK_TREE_MODEL_FILTER (model)); 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, &child_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_KEY_Escape || event->keyval == GDK_KEY_Left || event->keyval == GDK_KEY_KP_Left || event->keyval == GDK_KEY_Right || event->keyval == GDK_KEY_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_KEY_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_KEY_Right || event->keyval == GDK_KEY_KP_Right || event->keyval == GDK_KEY_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_KEY_Tab || event->keyval == GDK_KEY_KP_Tab || event->keyval == GDK_KEY_ISO_Left_Tab) { _gtk_entry_reset_im_context (GTK_ENTRY (widget)); _gtk_entry_completion_popdown (completion); g_free (completion->priv->completion_prefix); completion->priv->completion_prefix = NULL; return FALSE; } else if (event->keyval == GDK_KEY_ISO_Enter || event->keyval == GDK_KEY_KP_Enter || event->keyval == GDK_KEY_Return) { GtkTreeIter iter; GtkTreeModel *model = NULL; GtkTreeModel *child_model; GtkTreeIter child_iter; GtkTreeSelection *sel; gboolean retval = TRUE; _gtk_entry_reset_im_context (GTK_ENTRY (widget)); _gtk_entry_completion_popdown (completion); if (completion->priv->current_selected < matches) { 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)) { gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, &iter); child_model = gtk_tree_model_filter_get_model (GTK_TREE_MODEL_FILTER (model)); g_signal_handler_block (widget, completion->priv->changed_id); g_signal_emit_by_name (completion, "match-selected", child_model, &child_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) { sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (completion->priv->action_view)); if (gtk_tree_selection_get_selected (sel, &model, &iter)) { GtkTreePath *path; 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); } else retval = FALSE; } g_free (completion->priv->completion_prefix); completion->priv->completion_prefix = NULL; return retval; } return FALSE; } static void gtk_entry_completion_changed (GtkWidget *widget, gpointer user_data) { GtkEntryCompletion *completion = GTK_ENTRY_COMPLETION (user_data); GtkEntry *entry = GTK_ENTRY (widget); GtkEntryPrivate *priv = entry->priv; GdkDevice *device; /* (re)install completion timeout */ if (completion->priv->completion_timeout) g_source_remove (completion->priv->completion_timeout); if (!gtk_entry_get_text (entry)) return; /* no need to normalize for this test */ if (completion->priv->minimum_key_length > 0 && strcmp ("", gtk_entry_get_text (entry)) == 0) { if (gtk_widget_get_visible (completion->priv->popup_window)) _gtk_entry_completion_popdown (completion); return; } device = gtk_get_current_event_device (); if (device && gdk_device_get_source (device) == GDK_SOURCE_KEYBOARD) device = gdk_device_get_associated_device (device); if (device) priv->completion_device = device; 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), gtk_entry_buffer_get_length (get_buffer (entry))); 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: (allow-none): 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 (old->priv->check_completion_idle) { g_source_destroy (old->priv->check_completion_idle); old->priv->check_completion_idle = NULL; } if (gtk_widget_get_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); g_object_notify (G_OBJECT (entry), "completion"); } /** * gtk_entry_get_completion: * @entry: A #GtkEntry * * Returns the auxiliary completion object currently in use by @entry. * * Return value: (transfer none): 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: (transfer none): 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); } /** * gtk_entry_set_progress_fraction: * @entry: a #GtkEntry * @fraction: fraction of the task that's been completed * * Causes the entry's progress indicator to "fill in" the given * fraction of the bar. The fraction should be between 0.0 and 1.0, * inclusive. * * Since: 2.16 */ void gtk_entry_set_progress_fraction (GtkEntry *entry, gdouble fraction) { GtkWidget *widget; GtkEntryPrivate *private; gdouble old_fraction; gint x, y, width, height; gint old_x, old_y, old_width, old_height; g_return_if_fail (GTK_IS_ENTRY (entry)); widget = GTK_WIDGET (entry); private = entry->priv; if (private->progress_pulse_mode) old_fraction = -1; else old_fraction = private->progress_fraction; if (gtk_widget_is_drawable (widget)) get_progress_area (widget, &old_x, &old_y, &old_width, &old_height); fraction = CLAMP (fraction, 0.0, 1.0); private->progress_fraction = fraction; private->progress_pulse_mode = FALSE; private->progress_pulse_current = 0.0; if (gtk_widget_is_drawable (widget)) { get_progress_area (widget, &x, &y, &width, &height); if ((x != old_x) || (y != old_y) || (width != old_width) || (height != old_height)) gtk_widget_queue_draw (widget); } if (fraction != old_fraction) g_object_notify (G_OBJECT (entry), "progress-fraction"); } /** * gtk_entry_get_progress_fraction: * @entry: a #GtkEntry * * Returns the current fraction of the task that's been completed. * See gtk_entry_set_progress_fraction(). * * Return value: a fraction from 0.0 to 1.0 * * Since: 2.16 */ gdouble gtk_entry_get_progress_fraction (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0.0); return entry->priv->progress_fraction; } /** * gtk_entry_set_progress_pulse_step: * @entry: a #GtkEntry * @fraction: fraction between 0.0 and 1.0 * * Sets the fraction of total entry width to move the progress * bouncing block for each call to gtk_entry_progress_pulse(). * * Since: 2.16 */ void gtk_entry_set_progress_pulse_step (GtkEntry *entry, gdouble fraction) { GtkEntryPrivate *private; g_return_if_fail (GTK_IS_ENTRY (entry)); private = entry->priv; fraction = CLAMP (fraction, 0.0, 1.0); if (fraction != private->progress_pulse_fraction) { private->progress_pulse_fraction = fraction; gtk_widget_queue_draw (GTK_WIDGET (entry)); g_object_notify (G_OBJECT (entry), "progress-pulse-step"); } } /** * gtk_entry_get_progress_pulse_step: * @entry: a #GtkEntry * * Retrieves the pulse step set with gtk_entry_set_progress_pulse_step(). * * Return value: a fraction from 0.0 to 1.0 * * Since: 2.16 */ gdouble gtk_entry_get_progress_pulse_step (GtkEntry *entry) { g_return_val_if_fail (GTK_IS_ENTRY (entry), 0.0); return entry->priv->progress_pulse_fraction; } /** * gtk_entry_progress_pulse: * @entry: a #GtkEntry * * Indicates that some progress is made, but you don't know how much. * Causes the entry's progress indicator to enter "activity mode," * where a block bounces back and forth. Each call to * gtk_entry_progress_pulse() causes the block to move by a little bit * (the amount of movement per pulse is determined by * gtk_entry_set_progress_pulse_step()). * * Since: 2.16 */ void gtk_entry_progress_pulse (GtkEntry *entry) { GtkEntryPrivate *private; g_return_if_fail (GTK_IS_ENTRY (entry)); private = entry->priv; if (private->progress_pulse_mode) { if (private->progress_pulse_way_back) { private->progress_pulse_current -= private->progress_pulse_fraction; if (private->progress_pulse_current < 0.0) { private->progress_pulse_current = 0.0; private->progress_pulse_way_back = FALSE; } } else { private->progress_pulse_current += private->progress_pulse_fraction; if (private->progress_pulse_current > 1.0 - private->progress_pulse_fraction) { private->progress_pulse_current = 1.0 - private->progress_pulse_fraction; private->progress_pulse_way_back = TRUE; } } } else { private->progress_fraction = 0.0; private->progress_pulse_mode = TRUE; private->progress_pulse_way_back = FALSE; private->progress_pulse_current = 0.0; } gtk_widget_queue_draw (GTK_WIDGET (entry)); } /** * gtk_entry_set_placeholder_text: * @entry: a #GtkEntry * @text: a string to be displayed when @entry is empty an unfocused, or %NULL * * Sets text to be displayed in @entry when it is empty and unfocused. * This can be used to give a visual hint of the expected contents of * the #GtkEntry. * * Note that since the placeholder text gets removed when the entry * received focus, using this feature is a bit problematic if the entry * is given the initial focus in a window. Sometimes this can be * worked around by delaying the initial focus setting until the * first key event arrives. * * Since: 3.2 **/ void gtk_entry_set_placeholder_text (GtkEntry *entry, const gchar *text) { GtkEntryPrivate *priv; g_return_if_fail (GTK_IS_ENTRY (entry)); priv = entry->priv; if (g_strcmp0 (priv->placeholder_text, text) == 0) return; g_free (priv->placeholder_text); priv->placeholder_text = g_strdup (text); gtk_entry_recompute (entry); g_object_notify (G_OBJECT (entry), "placeholder-text"); } /** * gtk_entry_get_placeholder_text: * @entry: a #GtkEntry * * Retrieves the text that will be displayed when @entry is empty and unfocused * * Returns: a pointer to the placeholder text as a string. This string points to internally allocated * storage in the widget and must not be freed, modified or stored. * * Since: 3.2 **/ const gchar * gtk_entry_get_placeholder_text (GtkEntry *entry) { GtkEntryPrivate *priv; g_return_val_if_fail (GTK_IS_ENTRY (entry), NULL); priv = entry->priv; return priv->placeholder_text; } /* Caps Lock warning for password entries */ static void show_capslock_feedback (GtkEntry *entry, const gchar *text) { GtkEntryPrivate *priv = entry->priv; if (gtk_entry_get_icon_storage_type (entry, GTK_ENTRY_ICON_SECONDARY) == GTK_IMAGE_EMPTY) { gtk_entry_set_icon_from_stock (entry, GTK_ENTRY_ICON_SECONDARY, GTK_STOCK_CAPS_LOCK_WARNING); gtk_entry_set_icon_activatable (entry, GTK_ENTRY_ICON_SECONDARY, FALSE); priv->caps_lock_warning_shown = TRUE; } if (priv->caps_lock_warning_shown) gtk_entry_set_icon_tooltip_text (entry, GTK_ENTRY_ICON_SECONDARY, text); else g_warning ("Can't show Caps Lock warning, since secondary icon is set"); } static void remove_capslock_feedback (GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; if (priv->caps_lock_warning_shown) { gtk_entry_set_icon_from_stock (entry, GTK_ENTRY_ICON_SECONDARY, NULL); priv->caps_lock_warning_shown = FALSE; } } static void keymap_state_changed (GdkKeymap *keymap, GtkEntry *entry) { GtkEntryPrivate *priv = entry->priv; char *text = NULL; if (gtk_entry_get_display_mode (entry) != DISPLAY_NORMAL && priv->caps_lock_warning) { if (gdk_keymap_get_num_lock_state (keymap) && gdk_keymap_get_caps_lock_state (keymap)) text = _("Caps Lock and Num Lock are on"); else if (gdk_keymap_get_num_lock_state (keymap)) text = _("Num Lock is on"); else if (gdk_keymap_get_caps_lock_state (keymap)) text = _("Caps Lock is on"); } if (text) show_capslock_feedback (entry, text); else remove_capslock_feedback (entry); } /* * _gtk_entry_set_is_cell_renderer: * @entry: a #GtkEntry * @is_cell_renderer: new value * * This is a helper function for GtkComboBox. A GtkEntry in a GtkComboBox * is supposed to behave like a GtkCellEditable when placed in a combo box. * * I.e take up its allocation and get GtkEntry->is_cell_renderer = TRUE. * */ void _gtk_entry_set_is_cell_renderer (GtkEntry *entry, gboolean is_cell_renderer) { entry->priv->is_cell_renderer = is_cell_renderer; }