1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free
16 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
21 * file for a list of people on the GTK+ Team. See the ChangeLog
22 * files for a list of changes. These files are distributed with
23 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
30 #include "gtkmarshalers.h"
31 #include "gtkwindow.h"
32 #include "gdk/gdkkeysyms.h"
33 #include "gtkclipboard.h"
34 #include <pango/pango.h>
35 #include "gtkimagemenuitem.h"
37 #include "gtkseparatormenuitem.h"
38 #include "gtkmenuitem.h"
39 #include "gtknotebook.h"
41 #include "gtkbindings.h"
43 struct _GtkLabelSelectionInfo
46 gint selection_anchor;
48 GtkWidget *popup_menu;
74 static guint signals[LAST_SIGNAL] = { 0 };
76 static void gtk_label_class_init (GtkLabelClass *klass);
77 static void gtk_label_init (GtkLabel *label);
78 static void gtk_label_set_property (GObject *object,
82 static void gtk_label_get_property (GObject *object,
86 static void gtk_label_destroy (GtkObject *object);
87 static void gtk_label_finalize (GObject *object);
88 static void gtk_label_size_request (GtkWidget *widget,
89 GtkRequisition *requisition);
90 static void gtk_label_size_allocate (GtkWidget *widget,
91 GtkAllocation *allocation);
92 static void gtk_label_state_changed (GtkWidget *widget,
94 static void gtk_label_style_set (GtkWidget *widget,
95 GtkStyle *previous_style);
96 static void gtk_label_direction_changed (GtkWidget *widget,
97 GtkTextDirection previous_dir);
98 static gint gtk_label_expose (GtkWidget *widget,
99 GdkEventExpose *event);
101 static void gtk_label_realize (GtkWidget *widget);
102 static void gtk_label_unrealize (GtkWidget *widget);
103 static void gtk_label_map (GtkWidget *widget);
104 static void gtk_label_unmap (GtkWidget *widget);
105 static gint gtk_label_button_press (GtkWidget *widget,
106 GdkEventButton *event);
107 static gint gtk_label_button_release (GtkWidget *widget,
108 GdkEventButton *event);
109 static gint gtk_label_motion (GtkWidget *widget,
110 GdkEventMotion *event);
113 static void gtk_label_set_text_internal (GtkLabel *label,
115 static void gtk_label_set_label_internal (GtkLabel *label,
117 static void gtk_label_set_use_markup_internal (GtkLabel *label,
119 static void gtk_label_set_use_underline_internal (GtkLabel *label,
121 static void gtk_label_set_attributes_internal (GtkLabel *label,
122 PangoAttrList *attrs);
123 static void gtk_label_set_uline_text_internal (GtkLabel *label,
125 static void gtk_label_set_pattern_internal (GtkLabel *label,
126 const gchar *pattern);
127 static void set_markup (GtkLabel *label,
129 gboolean with_uline);
130 static void gtk_label_recalculate (GtkLabel *label);
131 static void gtk_label_hierarchy_changed (GtkWidget *widget,
132 GtkWidget *old_toplevel);
133 static void gtk_label_screen_changed (GtkWidget *widget,
134 GdkScreen *old_screen);
136 static void gtk_label_create_window (GtkLabel *label);
137 static void gtk_label_destroy_window (GtkLabel *label);
138 static void gtk_label_clear_layout (GtkLabel *label);
139 static void gtk_label_ensure_layout (GtkLabel *label);
140 static void gtk_label_select_region_index (GtkLabel *label,
144 static gboolean gtk_label_mnemonic_activate (GtkWidget *widget,
145 gboolean group_cycling);
146 static void gtk_label_setup_mnemonic (GtkLabel *label,
148 static gboolean gtk_label_focus (GtkWidget *widget,
149 GtkDirectionType direction);
151 /* For selectable lables: */
152 static void gtk_label_move_cursor (GtkLabel *label,
153 GtkMovementStep step,
155 gboolean extend_selection);
156 static void gtk_label_copy_clipboard (GtkLabel *label);
157 static void gtk_label_select_all (GtkLabel *label);
158 static void gtk_label_do_popup (GtkLabel *label,
159 GdkEventButton *event);
161 static gint gtk_label_move_forward_word (GtkLabel *label,
163 static gint gtk_label_move_backward_word (GtkLabel *label,
166 static GtkMiscClass *parent_class = NULL;
170 gtk_label_get_type (void)
172 static GType label_type = 0;
176 static const GTypeInfo label_info =
178 sizeof (GtkLabelClass),
179 NULL, /* base_init */
180 NULL, /* base_finalize */
181 (GClassInitFunc) gtk_label_class_init,
182 NULL, /* class_finalize */
183 NULL, /* class_data */
185 32, /* n_preallocs */
186 (GInstanceInitFunc) gtk_label_init,
189 label_type = g_type_register_static (GTK_TYPE_MISC, "GtkLabel",
197 add_move_binding (GtkBindingSet *binding_set,
200 GtkMovementStep step,
203 g_return_if_fail ((modmask & GDK_SHIFT_MASK) == 0);
205 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
209 G_TYPE_BOOLEAN, FALSE);
211 /* Selection-extending version */
212 gtk_binding_entry_add_signal (binding_set, keyval, modmask | GDK_SHIFT_MASK,
216 G_TYPE_BOOLEAN, TRUE);
220 gtk_label_class_init (GtkLabelClass *class)
222 GObjectClass *gobject_class = G_OBJECT_CLASS (class);
223 GtkObjectClass *object_class = GTK_OBJECT_CLASS (class);
224 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
225 GtkBindingSet *binding_set;
227 parent_class = g_type_class_peek_parent (class);
229 gobject_class->set_property = gtk_label_set_property;
230 gobject_class->get_property = gtk_label_get_property;
231 gobject_class->finalize = gtk_label_finalize;
233 object_class->destroy = gtk_label_destroy;
235 widget_class->size_request = gtk_label_size_request;
236 widget_class->size_allocate = gtk_label_size_allocate;
237 widget_class->state_changed = gtk_label_state_changed;
238 widget_class->style_set = gtk_label_style_set;
239 widget_class->direction_changed = gtk_label_direction_changed;
240 widget_class->expose_event = gtk_label_expose;
241 widget_class->realize = gtk_label_realize;
242 widget_class->unrealize = gtk_label_unrealize;
243 widget_class->map = gtk_label_map;
244 widget_class->unmap = gtk_label_unmap;
245 widget_class->button_press_event = gtk_label_button_press;
246 widget_class->button_release_event = gtk_label_button_release;
247 widget_class->motion_notify_event = gtk_label_motion;
248 widget_class->hierarchy_changed = gtk_label_hierarchy_changed;
249 widget_class->screen_changed = gtk_label_screen_changed;
250 widget_class->mnemonic_activate = gtk_label_mnemonic_activate;
251 widget_class->focus = gtk_label_focus;
253 class->move_cursor = gtk_label_move_cursor;
254 class->copy_clipboard = gtk_label_copy_clipboard;
256 signals[MOVE_CURSOR] =
257 g_signal_new ("move_cursor",
258 G_OBJECT_CLASS_TYPE (gobject_class),
259 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
260 G_STRUCT_OFFSET (GtkLabelClass, move_cursor),
262 _gtk_marshal_VOID__ENUM_INT_BOOLEAN,
264 GTK_TYPE_MOVEMENT_STEP,
268 signals[COPY_CLIPBOARD] =
269 g_signal_new ("copy_clipboard",
270 G_OBJECT_CLASS_TYPE (gobject_class),
271 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
272 G_STRUCT_OFFSET (GtkLabelClass, copy_clipboard),
274 _gtk_marshal_VOID__VOID,
277 signals[POPULATE_POPUP] =
278 g_signal_new ("populate_popup",
279 G_OBJECT_CLASS_TYPE (gobject_class),
281 G_STRUCT_OFFSET (GtkLabelClass, populate_popup),
283 _gtk_marshal_VOID__OBJECT,
287 g_object_class_install_property (gobject_class,
289 g_param_spec_string ("label",
291 _("The text of the label"),
294 g_object_class_install_property (gobject_class,
296 g_param_spec_boxed ("attributes",
298 _("A list of style attributes to apply to the text of the label"),
299 PANGO_TYPE_ATTR_LIST,
301 g_object_class_install_property (gobject_class,
303 g_param_spec_boolean ("use_markup",
305 _("The text of the label includes XML markup. See pango_parse_markup()"),
308 g_object_class_install_property (gobject_class,
310 g_param_spec_boolean ("use_underline",
312 _("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
316 g_object_class_install_property (gobject_class,
318 g_param_spec_enum ("justify",
320 _("The alignment of the lines in the text of the label relative to each other. This does NOT affect the alignment of the label within its allocation. See GtkMisc::xalign for that"),
321 GTK_TYPE_JUSTIFICATION,
325 g_object_class_install_property (gobject_class,
327 g_param_spec_string ("pattern",
329 _("A string with _ characters in positions correspond to characters in the text to underline"),
333 g_object_class_install_property (gobject_class,
335 g_param_spec_boolean ("wrap",
337 _("If set, wrap lines if the text becomes too wide"),
340 g_object_class_install_property (gobject_class,
342 g_param_spec_boolean ("selectable",
344 _("Whether the label text can be selected with the mouse"),
347 g_object_class_install_property (gobject_class,
348 PROP_MNEMONIC_KEYVAL,
349 g_param_spec_uint ("mnemonic_keyval",
351 _("The mnemonic accelerator key for this label"),
356 g_object_class_install_property (gobject_class,
357 PROP_MNEMONIC_WIDGET,
358 g_param_spec_object ("mnemonic_widget",
359 _("Mnemonic widget"),
360 _("The widget to be activated when the label's mnemonic "
365 g_object_class_install_property (gobject_class,
366 PROP_CURSOR_POSITION,
367 g_param_spec_int ("cursor_position",
368 _("Cursor Position"),
369 _("The current position of the insertion cursor in chars"),
375 g_object_class_install_property (gobject_class,
376 PROP_SELECTION_BOUND,
377 g_param_spec_int ("selection_bound",
378 _("Selection Bound"),
379 _("The position of the opposite end of the selection from the cursor in chars"),
389 binding_set = gtk_binding_set_by_class (class);
391 /* Moving the insertion point */
392 add_move_binding (binding_set, GDK_Right, 0,
393 GTK_MOVEMENT_VISUAL_POSITIONS, 1);
395 add_move_binding (binding_set, GDK_Left, 0,
396 GTK_MOVEMENT_VISUAL_POSITIONS, -1);
398 add_move_binding (binding_set, GDK_KP_Right, 0,
399 GTK_MOVEMENT_VISUAL_POSITIONS, 1);
401 add_move_binding (binding_set, GDK_KP_Left, 0,
402 GTK_MOVEMENT_VISUAL_POSITIONS, -1);
404 add_move_binding (binding_set, GDK_f, GDK_CONTROL_MASK,
405 GTK_MOVEMENT_LOGICAL_POSITIONS, 1);
407 add_move_binding (binding_set, GDK_b, GDK_CONTROL_MASK,
408 GTK_MOVEMENT_LOGICAL_POSITIONS, -1);
410 add_move_binding (binding_set, GDK_Right, GDK_CONTROL_MASK,
411 GTK_MOVEMENT_WORDS, 1);
413 add_move_binding (binding_set, GDK_Left, GDK_CONTROL_MASK,
414 GTK_MOVEMENT_WORDS, -1);
416 add_move_binding (binding_set, GDK_KP_Right, GDK_CONTROL_MASK,
417 GTK_MOVEMENT_WORDS, 1);
419 add_move_binding (binding_set, GDK_KP_Left, GDK_CONTROL_MASK,
420 GTK_MOVEMENT_WORDS, -1);
422 add_move_binding (binding_set, GDK_a, GDK_CONTROL_MASK,
423 GTK_MOVEMENT_PARAGRAPH_ENDS, -1);
425 add_move_binding (binding_set, GDK_e, GDK_CONTROL_MASK,
426 GTK_MOVEMENT_PARAGRAPH_ENDS, 1);
428 add_move_binding (binding_set, GDK_f, GDK_MOD1_MASK,
429 GTK_MOVEMENT_WORDS, 1);
431 add_move_binding (binding_set, GDK_b, GDK_MOD1_MASK,
432 GTK_MOVEMENT_WORDS, -1);
434 add_move_binding (binding_set, GDK_Home, 0,
435 GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1);
437 add_move_binding (binding_set, GDK_End, 0,
438 GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1);
440 add_move_binding (binding_set, GDK_KP_Home, 0,
441 GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1);
443 add_move_binding (binding_set, GDK_KP_End, 0,
444 GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1);
446 add_move_binding (binding_set, GDK_Home, GDK_CONTROL_MASK,
447 GTK_MOVEMENT_BUFFER_ENDS, -1);
449 add_move_binding (binding_set, GDK_End, GDK_CONTROL_MASK,
450 GTK_MOVEMENT_BUFFER_ENDS, 1);
452 add_move_binding (binding_set, GDK_KP_Home, GDK_CONTROL_MASK,
453 GTK_MOVEMENT_BUFFER_ENDS, -1);
455 add_move_binding (binding_set, GDK_KP_End, GDK_CONTROL_MASK,
456 GTK_MOVEMENT_BUFFER_ENDS, 1);
459 gtk_binding_entry_add_signal (binding_set, GDK_c, GDK_CONTROL_MASK,
460 "copy_clipboard", 0);
464 gtk_label_set_property (GObject *object,
471 label = GTK_LABEL (object);
476 gtk_label_set_label (label, g_value_get_string (value));
478 case PROP_ATTRIBUTES:
479 gtk_label_set_attributes (label, g_value_get_boxed (value));
481 case PROP_USE_MARKUP:
482 gtk_label_set_use_markup (label, g_value_get_boolean (value));
484 case PROP_USE_UNDERLINE:
485 gtk_label_set_use_underline (label, g_value_get_boolean (value));
488 gtk_label_set_justify (label, g_value_get_enum (value));
491 gtk_label_set_pattern (label, g_value_get_string (value));
494 gtk_label_set_line_wrap (label, g_value_get_boolean (value));
496 case PROP_SELECTABLE:
497 gtk_label_set_selectable (label, g_value_get_boolean (value));
499 case PROP_MNEMONIC_WIDGET:
500 gtk_label_set_mnemonic_widget (label, (GtkWidget*) g_value_get_object (value));
503 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
509 gtk_label_get_property (GObject *object,
516 label = GTK_LABEL (object);
521 g_value_set_string (value, label->label);
523 case PROP_ATTRIBUTES:
524 g_value_set_boxed (value, label->attrs);
526 case PROP_USE_MARKUP:
527 g_value_set_boolean (value, label->use_markup);
529 case PROP_USE_UNDERLINE:
530 g_value_set_boolean (value, label->use_underline);
533 g_value_set_enum (value, label->jtype);
536 g_value_set_boolean (value, label->wrap);
538 case PROP_SELECTABLE:
539 g_value_set_boolean (value, gtk_label_get_selectable (label));
541 case PROP_MNEMONIC_KEYVAL:
542 g_value_set_uint (value, label->mnemonic_keyval);
544 case PROP_MNEMONIC_WIDGET:
545 g_value_set_object (value, (GObject*) label->mnemonic_widget);
547 case PROP_CURSOR_POSITION:
548 if (label->select_info)
550 gint offset = g_utf8_pointer_to_offset (label->text,
551 label->text + label->select_info->selection_end);
552 g_value_set_int (value, offset);
555 g_value_set_int (value, 0);
557 case PROP_SELECTION_BOUND:
558 if (label->select_info)
560 gint offset = g_utf8_pointer_to_offset (label->text,
561 label->text + label->select_info->selection_anchor);
562 g_value_set_int (value, offset);
565 g_value_set_int (value, 0);
569 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
575 gtk_label_init (GtkLabel *label)
577 GTK_WIDGET_SET_FLAGS (label, GTK_NO_WINDOW);
581 label->jtype = GTK_JUSTIFY_LEFT;
584 label->use_underline = FALSE;
585 label->use_markup = FALSE;
587 label->mnemonic_keyval = GDK_VoidSymbol;
588 label->layout = NULL;
592 label->mnemonic_widget = NULL;
593 label->mnemonic_window = NULL;
595 gtk_label_set_text (label, "");
600 * @str: The text of the label
602 * Creates a new label with the given text inside it. You can
603 * pass %NULL to get an empty label widget.
605 * Return value: the new #GtkLabel
608 gtk_label_new (const gchar *str)
612 label = g_object_new (GTK_TYPE_LABEL, NULL);
615 gtk_label_set_text (label, str);
617 return GTK_WIDGET (label);
621 * gtk_label_new_with_mnemonic:
622 * @str: The text of the label, with an underscore in front of the
625 * Creates a new #GtkLabel, containing the text in @str.
627 * If characters in @str are preceded by an underscore, they are
628 * underlined. If you need a literal underscore character in a label, use
629 * '__' (two underscores). The first underlined character represents a
630 * keyboard accelerator called a mnemonic. The mnemonic key can be used
631 * to activate another widget, chosen automatically, or explicitly using
632 * gtk_label_set_mnemonic_widget().
634 * If gtk_label_set_mnemonic_widget()
635 * is not called, then the first activatable ancestor of the #GtkLabel
636 * will be chosen as the mnemonic widget. For instance, if the
637 * label is inside a button or menu item, the button or menu item will
638 * automatically become the mnemonic widget and be activated by
641 * Return value: the new #GtkLabel
644 gtk_label_new_with_mnemonic (const gchar *str)
648 label = g_object_new (GTK_TYPE_LABEL, NULL);
651 gtk_label_set_text_with_mnemonic (label, str);
653 return GTK_WIDGET (label);
657 gtk_label_mnemonic_activate (GtkWidget *widget,
658 gboolean group_cycling)
662 if (GTK_LABEL (widget)->mnemonic_widget)
663 return gtk_widget_mnemonic_activate (GTK_LABEL (widget)->mnemonic_widget, group_cycling);
665 /* Try to find the widget to activate by traversing the
668 parent = widget->parent;
670 if (parent && GTK_IS_NOTEBOOK (parent))
675 if (GTK_WIDGET_CAN_FOCUS (parent) ||
676 (!group_cycling && GTK_WIDGET_GET_CLASS (parent)->activate_signal) ||
677 (parent->parent && GTK_IS_NOTEBOOK (parent->parent)) ||
678 (GTK_IS_MENU_ITEM (parent)))
679 return gtk_widget_mnemonic_activate (parent, group_cycling);
680 parent = parent->parent;
683 /* barf if there was nothing to activate */
684 g_warning ("Couldn't find a target for a mnemonic activation.");
685 gdk_display_beep (gtk_widget_get_display (widget));
691 gtk_label_setup_mnemonic (GtkLabel *label,
696 if (last_key != GDK_VoidSymbol && label->mnemonic_window)
698 gtk_window_remove_mnemonic (label->mnemonic_window,
701 label->mnemonic_window = NULL;
704 if (label->mnemonic_keyval == GDK_VoidSymbol)
707 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (label));
708 if (GTK_WIDGET_TOPLEVEL (toplevel))
710 gtk_window_add_mnemonic (GTK_WINDOW (toplevel),
711 label->mnemonic_keyval,
713 label->mnemonic_window = GTK_WINDOW (toplevel);
718 gtk_label_hierarchy_changed (GtkWidget *widget,
719 GtkWidget *old_toplevel)
721 GtkLabel *label = GTK_LABEL (widget);
723 gtk_label_setup_mnemonic (label, label->mnemonic_keyval);
727 gtk_label_screen_changed (GtkWidget *widget,
728 GdkScreen *old_screen)
730 gtk_label_clear_layout (GTK_LABEL (widget));
734 label_mnemonic_widget_weak_notify (gpointer data,
735 GObject *where_the_object_was)
737 GtkLabel *label = data;
739 label->mnemonic_widget = NULL;
740 g_object_notify (G_OBJECT (label), "mnemonic_widget");
744 * gtk_label_set_mnemonic_widget:
745 * @label: a #GtkLabel
746 * @widget: the target #GtkWidget
748 * If the label has been set so that it has an mnemonic key (using
749 * i.e. gtk_label_set_markup_with_mnemonic(),
750 * gtk_label_set_text_with_mnemonic(), gtk_label_new_with_mnemonic()
751 * or the "use_underline" property) the label can be associated with a
752 * widget that is the target of the mnemonic. When the label is inside
753 * a widget (like a #GtkButton or a #GtkNotebook tab) it is
754 * automatically associated with the correct widget, but sometimes
755 * (i.e. when the target is a #GtkEntry next to the label) you need to
756 * set it explicitly using this function.
758 * The target widget will be accelerated by emitting "mnemonic_activate" on it.
759 * The default handler for this signal will activate the widget if there are no
760 * mnemonic collisions and toggle focus between the colliding widgets otherwise.
763 gtk_label_set_mnemonic_widget (GtkLabel *label,
766 g_return_if_fail (GTK_IS_LABEL (label));
768 g_return_if_fail (GTK_IS_WIDGET (widget));
770 if (label->mnemonic_widget)
771 g_object_weak_unref (G_OBJECT (label->mnemonic_widget),
772 label_mnemonic_widget_weak_notify,
774 label->mnemonic_widget = widget;
775 if (label->mnemonic_widget)
776 g_object_weak_ref (G_OBJECT (label->mnemonic_widget),
777 label_mnemonic_widget_weak_notify,
780 g_object_notify (G_OBJECT (label), "mnemonic_widget");
784 * gtk_label_get_mnemonic_widget:
785 * @label: a #GtkLabel
787 * Retrieves the target of the mnemonic (keyboard shortcut) of this
788 * label. See gtk_label_set_mnemonic_widget ().
790 * Return value: the target of the label's mnemonic, or %NULL if none
791 * has been set and the default algorithm will be used.
794 gtk_label_get_mnemonic_widget (GtkLabel *label)
796 g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
798 return label->mnemonic_widget;
802 * gtk_label_get_mnemonic_keyval:
803 * @label: a #GtkLabel
805 * If the label has been set so that it has an mnemonic key this function
806 * returns the keyval used for the mnemonic accelerator. If there is no
807 * mnemonic set up it returns #GDK_VoidSymbol.
809 * Returns: GDK keyval usable for accelerators, or #GDK_VoidSymbol
812 gtk_label_get_mnemonic_keyval (GtkLabel *label)
814 g_return_val_if_fail (GTK_IS_LABEL (label), GDK_VoidSymbol);
816 return label->mnemonic_keyval;
820 gtk_label_set_text_internal (GtkLabel *label,
823 g_free (label->text);
827 gtk_label_select_region_index (label, 0, 0);
831 gtk_label_set_label_internal (GtkLabel *label,
834 g_free (label->label);
838 g_object_notify (G_OBJECT (label), "label");
842 gtk_label_set_use_markup_internal (GtkLabel *label,
846 if (label->use_markup != val)
848 g_object_notify (G_OBJECT (label), "use_markup");
849 label->use_markup = val;
854 gtk_label_set_use_underline_internal (GtkLabel *label,
858 if (label->use_underline != val)
860 g_object_notify (G_OBJECT (label), "use_underline");
861 label->use_underline = val;
866 gtk_label_set_attributes_internal (GtkLabel *label,
867 PangoAttrList *attrs)
870 pango_attr_list_ref (attrs);
873 pango_attr_list_unref (label->attrs);
875 if (!label->use_markup && !label->use_underline)
877 pango_attr_list_ref (attrs);
878 if (label->effective_attrs)
879 pango_attr_list_unref (label->effective_attrs);
880 label->effective_attrs = attrs;
883 label->attrs = attrs;
884 g_object_notify (G_OBJECT (label), "attributes");
888 /* Calculates text, attrs and mnemonic_keyval from
889 * label, use_underline and use_markup
892 gtk_label_recalculate (GtkLabel *label)
894 if (label->use_markup)
895 set_markup (label, label->label, label->use_underline);
898 if (label->use_underline)
899 gtk_label_set_uline_text_internal (label, label->label);
902 gtk_label_set_text_internal (label, g_strdup (label->label));
904 pango_attr_list_ref (label->attrs);
905 if (label->effective_attrs)
906 pango_attr_list_unref (label->effective_attrs);
907 label->effective_attrs = label->attrs;
911 if (!label->use_underline)
913 guint keyval = label->mnemonic_keyval;
915 label->mnemonic_keyval = GDK_VoidSymbol;
916 gtk_label_setup_mnemonic (label, keyval);
919 gtk_label_clear_layout (label);
920 gtk_widget_queue_resize (GTK_WIDGET (label));
924 * gtk_label_set_text:
925 * @label: a #GtkLabel
926 * @str: The text you want to set.
928 * Sets the text within the #GtkLabel widget. It overwrites any text that
931 * This will also clear any previously set mnemonic accelerators.
934 gtk_label_set_text (GtkLabel *label,
937 g_return_if_fail (GTK_IS_LABEL (label));
939 g_object_freeze_notify (G_OBJECT (label));
941 gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
942 gtk_label_set_use_markup_internal (label, FALSE);
943 gtk_label_set_use_underline_internal (label, FALSE);
945 gtk_label_recalculate (label);
947 g_object_thaw_notify (G_OBJECT (label));
951 * gtk_label_set_attributes:
952 * @label: a #GtkLabel
953 * @attrs: a #PangoAttrList
955 * Sets a #PangoAttrList; the attributes in the list are applied to the
956 * label text. The attributes set with this function will be ignored
957 * if the "use_underline" property or the "use_markup" property
961 gtk_label_set_attributes (GtkLabel *label,
962 PangoAttrList *attrs)
964 g_return_if_fail (GTK_IS_LABEL (label));
966 gtk_label_set_attributes_internal (label, attrs);
968 gtk_label_clear_layout (label);
969 gtk_widget_queue_resize (GTK_WIDGET (label));
973 * gtk_label_get_attributes:
974 * @label: a #GtkLabel
976 * Gets the attribute list that was set on the label using
977 * gtk_label_set_attributes(), if any. This function does
978 * not reflect attributes that come from the labels markup
979 * (see gtk_label_set_markup()). If you want to get the
980 * effective attributes for the label, use
981 * pango_layout_get_attribute (gtk_label_get_layout (label)).
983 * Return value: the attribute list, or %NULL if none was set.
986 gtk_label_get_attributes (GtkLabel *label)
988 g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
994 * gtk_label_set_label:
995 * @label: a #GtkLabel
996 * @str: the new text to set for the label
998 * Sets the text of the label. The label is interpreted as
999 * including embedded underlines and/or Pango markup depending
1000 * on the values of label->use_underline and label->use_markup.
1003 gtk_label_set_label (GtkLabel *label,
1008 g_return_if_fail (GTK_IS_LABEL (label));
1009 g_return_if_fail (str != NULL);
1011 last_keyval = label->mnemonic_keyval;
1013 gtk_label_set_label_internal (label, g_strdup (str));
1014 gtk_label_recalculate (label);
1015 if (last_keyval != label->mnemonic_keyval)
1016 gtk_label_setup_mnemonic (label, last_keyval);
1020 * gtk_label_get_label:
1021 * @label: a #GtkLabel
1023 * Fetches the text from a label widget including any embedded
1024 * underlines indicating mnemonics and Pango markup. (See
1025 * gtk_label_get_text ()).
1027 * Return value: the text of the label widget. This string is
1028 * owned by the widget and must not be modified or freed.
1030 G_CONST_RETURN gchar *
1031 gtk_label_get_label (GtkLabel *label)
1033 g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
1035 return label->label;
1039 set_markup (GtkLabel *label,
1041 gboolean with_uline)
1044 GError *error = NULL;
1045 PangoAttrList *attrs = NULL;
1046 gunichar accel_char = 0;
1048 if (!pango_parse_markup (str,
1050 with_uline ? '_' : 0,
1053 with_uline ? &accel_char : NULL,
1056 g_warning ("Failed to set label from markup due to error parsing markup: %s",
1058 g_error_free (error);
1063 gtk_label_set_text_internal (label, text);
1067 if (label->effective_attrs)
1068 pango_attr_list_unref (label->effective_attrs);
1069 label->effective_attrs = attrs;
1072 if (accel_char != 0)
1073 label->mnemonic_keyval = gdk_keyval_to_lower (gdk_unicode_to_keyval (accel_char));
1075 label->mnemonic_keyval = GDK_VoidSymbol;
1079 * gtk_label_set_markup:
1080 * @label: a #GtkLabel
1081 * @str: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
1083 * Parses @str which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>,
1084 * setting the label's text and attribute list based on the parse results.
1087 gtk_label_set_markup (GtkLabel *label,
1090 g_return_if_fail (GTK_IS_LABEL (label));
1092 gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
1093 gtk_label_set_use_markup_internal (label, TRUE);
1094 gtk_label_set_use_underline_internal (label, FALSE);
1096 gtk_label_recalculate (label);
1100 * gtk_label_set_markup_with_mnemonic:
1101 * @label: a #GtkLabel
1102 * @str: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
1104 * Parses @str which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>,
1105 * setting the label's text and attribute list based on the parse results.
1106 * If characters in @str are preceded by an underscore, they are underlined
1107 * indicating that they represent a keyboard accelerator called a mnemonic.
1109 * The mnemonic key can be used to activate another widget, chosen automatically,
1110 * or explicitly using gtk_label_set_mnemonic_widget().
1113 gtk_label_set_markup_with_mnemonic (GtkLabel *label,
1117 g_return_if_fail (GTK_IS_LABEL (label));
1119 last_keyval = label->mnemonic_keyval;
1120 gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
1121 gtk_label_set_use_markup_internal (label, TRUE);
1122 gtk_label_set_use_underline_internal (label, TRUE);
1124 gtk_label_recalculate (label);
1125 gtk_label_setup_mnemonic (label, last_keyval);
1129 * gtk_label_get_text:
1130 * @label: a #GtkLabel
1132 * Fetches the text from a label widget, as displayed on the
1133 * screen. This does not include any embedded underlines
1134 * indicating mnemonics or Pango markup. (See gtk_label_get_label())
1136 * Return value: the text in the label widget. This is the internal
1137 * string used by the label, and must not be modified.
1139 G_CONST_RETURN gchar *
1140 gtk_label_get_text (GtkLabel *label)
1142 g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
1147 static PangoAttrList *
1148 gtk_label_pattern_to_attrs (GtkLabel *label,
1149 const gchar *pattern)
1152 const char *p = label->text;
1153 const char *q = pattern;
1154 PangoAttrList *attrs;
1156 attrs = pango_attr_list_new ();
1160 while (*p && *q && *q != '_')
1162 p = g_utf8_next_char (p);
1166 while (*p && *q && *q == '_')
1168 p = g_utf8_next_char (p);
1174 PangoAttribute *attr = pango_attr_underline_new (PANGO_UNDERLINE_LOW);
1175 attr->start_index = start - label->text;
1176 attr->end_index = p - label->text;
1178 pango_attr_list_insert (attrs, attr);
1188 gtk_label_set_pattern_internal (GtkLabel *label,
1189 const gchar *pattern)
1191 PangoAttrList *attrs;
1192 g_return_if_fail (GTK_IS_LABEL (label));
1194 attrs = gtk_label_pattern_to_attrs (label, pattern);
1196 if (label->effective_attrs)
1197 pango_attr_list_unref (label->effective_attrs);
1198 label->effective_attrs = attrs;
1202 gtk_label_set_pattern (GtkLabel *label,
1203 const gchar *pattern)
1205 g_return_if_fail (GTK_IS_LABEL (label));
1207 gtk_label_set_pattern_internal (label, pattern);
1209 gtk_label_clear_layout (label);
1210 gtk_widget_queue_resize (GTK_WIDGET (label));
1215 * gtk_label_set_justify:
1216 * @label: a #GtkLabel
1217 * @jtype: a #GtkJustification
1219 * Sets the alignment of the lines in the text of the label relative to
1220 * each other. %GTK_JUSTIFY_LEFT is the default value when the
1221 * widget is first created with gtk_label_new(). If you instead want
1222 * to set the alignment of the label as a whole, use
1223 * gtk_misc_set_alignment() instead. gtk_label_set_justify() has no
1224 * effect on labels containing only a single line.
1227 gtk_label_set_justify (GtkLabel *label,
1228 GtkJustification jtype)
1230 g_return_if_fail (GTK_IS_LABEL (label));
1231 g_return_if_fail (jtype >= GTK_JUSTIFY_LEFT && jtype <= GTK_JUSTIFY_FILL);
1233 if ((GtkJustification) label->jtype != jtype)
1235 label->jtype = jtype;
1237 /* No real need to be this drastic, but easier than duplicating the code */
1238 gtk_label_clear_layout (label);
1240 g_object_notify (G_OBJECT (label), "justify");
1241 gtk_widget_queue_resize (GTK_WIDGET (label));
1246 * gtk_label_get_justify:
1247 * @label: a #GtkLabel
1249 * Returns the justification of the label. See gtk_label_set_justify ().
1251 * Return value: #GtkJustification
1254 gtk_label_get_justify (GtkLabel *label)
1256 g_return_val_if_fail (GTK_IS_LABEL (label), 0);
1258 return label->jtype;
1262 * gtk_label_set_line_wrap:
1263 * @label: a #GtkLabel
1264 * @wrap: the setting
1266 * Toggles line wrapping within the #GtkLabel widget. %TRUE makes it break
1267 * lines if text exceeds the widget's size. %FALSE lets the text get cut off
1268 * by the edge of the widget if it exceeds the widget size.
1271 gtk_label_set_line_wrap (GtkLabel *label,
1274 g_return_if_fail (GTK_IS_LABEL (label));
1276 wrap = wrap != FALSE;
1278 if (label->wrap != wrap)
1281 g_object_notify (G_OBJECT (label), "wrap");
1283 gtk_widget_queue_resize (GTK_WIDGET (label));
1288 * gtk_label_get_line_wrap:
1289 * @label: a #GtkLabel
1291 * Returns whether lines in the label are automatically wrapped. See gtk_label_set_line_wrap ().
1293 * Return value: %TRUE if the lines of the label are automatically wrapped.
1296 gtk_label_get_line_wrap (GtkLabel *label)
1298 g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
1304 gtk_label_get (GtkLabel *label,
1307 g_return_if_fail (GTK_IS_LABEL (label));
1308 g_return_if_fail (str != NULL);
1314 gtk_label_destroy (GtkObject *object)
1316 GtkLabel *label = GTK_LABEL (object);
1318 gtk_label_set_mnemonic_widget (label, NULL);
1320 GTK_OBJECT_CLASS (parent_class)->destroy (object);
1324 gtk_label_finalize (GObject *object)
1328 g_return_if_fail (GTK_IS_LABEL (object));
1330 label = GTK_LABEL (object);
1332 g_free (label->label);
1333 g_free (label->text);
1336 g_object_unref (label->layout);
1339 pango_attr_list_unref (label->attrs);
1341 if (label->effective_attrs)
1342 pango_attr_list_unref (label->effective_attrs);
1344 g_free (label->select_info);
1346 G_OBJECT_CLASS (parent_class)->finalize (object);
1350 gtk_label_clear_layout (GtkLabel *label)
1354 g_object_unref (label->layout);
1355 label->layout = NULL;
1359 typedef struct _LabelWrapWidth LabelWrapWidth;
1360 struct _LabelWrapWidth
1363 PangoFontDescription *font_desc;
1367 label_wrap_width_free (gpointer data)
1369 LabelWrapWidth *wrap_width = data;
1370 pango_font_description_free (wrap_width->font_desc);
1371 g_free (wrap_width);
1375 get_label_wrap_width (GtkLabel *label)
1377 PangoLayout *layout;
1378 GtkStyle *style = GTK_WIDGET (label)->style;
1380 LabelWrapWidth *wrap_width = g_object_get_data (G_OBJECT (style), "gtk-label-wrap-width");
1383 wrap_width = g_new0 (LabelWrapWidth, 1);
1384 g_object_set_data_full (G_OBJECT (style), "gtk-label-wrap-width",
1385 wrap_width, label_wrap_width_free);
1388 if (wrap_width->font_desc && pango_font_description_equal (wrap_width->font_desc, style->font_desc))
1389 return wrap_width->width;
1391 if (wrap_width->font_desc)
1392 pango_font_description_free (wrap_width->font_desc);
1394 wrap_width->font_desc = pango_font_description_copy (style->font_desc);
1396 layout = gtk_widget_create_pango_layout (GTK_WIDGET (label),
1397 "This long string gives a good enough length for any line to have.");
1398 pango_layout_get_size (layout, &wrap_width->width, NULL);
1399 g_object_unref (layout);
1401 return wrap_width->width;
1405 gtk_label_ensure_layout (GtkLabel *label)
1408 PangoRectangle logical_rect;
1409 gint rwidth, rheight;
1411 widget = GTK_WIDGET (label);
1413 rwidth = label->misc.xpad * 2;
1414 rheight = label->misc.ypad * 2;
1418 PangoAlignment align = PANGO_ALIGN_LEFT; /* Quiet gcc */
1420 label->layout = gtk_widget_create_pango_layout (widget, label->text);
1422 if (label->effective_attrs)
1423 pango_layout_set_attributes (label->layout, label->effective_attrs);
1425 switch (label->jtype)
1427 case GTK_JUSTIFY_LEFT:
1428 align = PANGO_ALIGN_LEFT;
1430 case GTK_JUSTIFY_RIGHT:
1431 align = PANGO_ALIGN_RIGHT;
1433 case GTK_JUSTIFY_CENTER:
1434 align = PANGO_ALIGN_CENTER;
1436 case GTK_JUSTIFY_FILL:
1437 /* FIXME: This just doesn't work to do this */
1438 align = PANGO_ALIGN_LEFT;
1439 pango_layout_set_justify (label->layout, TRUE);
1442 g_assert_not_reached();
1445 pango_layout_set_alignment (label->layout, align);
1449 GtkWidgetAuxInfo *aux_info;
1450 gint longest_paragraph;
1453 aux_info = _gtk_widget_get_aux_info (widget, FALSE);
1454 if (aux_info && aux_info->width > 0)
1455 pango_layout_set_width (label->layout, aux_info->width * PANGO_SCALE);
1458 GdkScreen *screen = gtk_widget_get_screen (GTK_WIDGET (label));
1461 pango_layout_set_width (label->layout, -1);
1462 pango_layout_get_extents (label->layout, NULL, &logical_rect);
1464 width = logical_rect.width;
1466 /* Try to guess a reasonable maximum width */
1467 longest_paragraph = width;
1469 wrap_width = get_label_wrap_width (label);
1470 width = MIN (width, wrap_width);
1472 PANGO_SCALE * (gdk_screen_get_width (screen) + 1) / 2);
1474 pango_layout_set_width (label->layout, width);
1475 pango_layout_get_extents (label->layout, NULL, &logical_rect);
1476 width = logical_rect.width;
1477 height = logical_rect.height;
1479 /* Unfortunately, the above may leave us with a very unbalanced looking paragraph,
1480 * so we try short search for a narrower width that leaves us with the same height
1482 if (longest_paragraph > 0)
1484 gint nlines, perfect_width;
1486 nlines = pango_layout_get_line_count (label->layout);
1487 perfect_width = (longest_paragraph + nlines - 1) / nlines;
1489 if (perfect_width < width)
1491 pango_layout_set_width (label->layout, perfect_width);
1492 pango_layout_get_extents (label->layout, NULL, &logical_rect);
1494 if (logical_rect.height <= height)
1495 width = logical_rect.width;
1498 gint mid_width = (perfect_width + width) / 2;
1500 if (mid_width > perfect_width)
1502 pango_layout_set_width (label->layout, mid_width);
1503 pango_layout_get_extents (label->layout, NULL, &logical_rect);
1505 if (logical_rect.height <= height)
1506 width = logical_rect.width;
1511 pango_layout_set_width (label->layout, width);
1514 else /* !label->wrap */
1515 pango_layout_set_width (label->layout, -1);
1520 gtk_label_size_request (GtkWidget *widget,
1521 GtkRequisition *requisition)
1525 PangoRectangle logical_rect;
1526 GtkWidgetAuxInfo *aux_info;
1528 g_return_if_fail (GTK_IS_LABEL (widget));
1529 g_return_if_fail (requisition != NULL);
1531 label = GTK_LABEL (widget);
1534 * If word wrapping is on, then the height requisition can depend
1537 * - Any width set on the widget via gtk_widget_set_usize().
1538 * - The padding of the widget (xpad, set by gtk_misc_set_padding)
1540 * Instead of trying to detect changes to these quantities, if we
1541 * are wrapping, we just rewrap for each size request. Since
1542 * size requisitions are cached by the GTK+ core, this is not
1547 gtk_label_clear_layout (label);
1549 gtk_label_ensure_layout (label);
1551 width = label->misc.xpad * 2;
1552 height = label->misc.ypad * 2;
1554 pango_layout_get_extents (label->layout, NULL, &logical_rect);
1556 aux_info = _gtk_widget_get_aux_info (widget, FALSE);
1557 if (label->wrap && aux_info && aux_info->width > 0)
1558 width += aux_info->width;
1560 width += PANGO_PIXELS (logical_rect.width);
1562 height += PANGO_PIXELS (logical_rect.height);
1564 requisition->width = width;
1565 requisition->height = height;
1569 gtk_label_size_allocate (GtkWidget *widget,
1570 GtkAllocation *allocation)
1574 label = GTK_LABEL (widget);
1576 (* GTK_WIDGET_CLASS (parent_class)->size_allocate) (widget, allocation);
1578 if (label->select_info && label->select_info->window)
1580 gdk_window_move_resize (label->select_info->window,
1584 allocation->height);
1589 gtk_label_state_changed (GtkWidget *widget,
1590 GtkStateType prev_state)
1594 label = GTK_LABEL (widget);
1596 if (label->select_info)
1597 gtk_label_select_region (label, 0, 0);
1599 if (GTK_WIDGET_CLASS (parent_class)->state_changed)
1600 GTK_WIDGET_CLASS (parent_class)->state_changed (widget, prev_state);
1604 gtk_label_style_set (GtkWidget *widget,
1605 GtkStyle *previous_style)
1609 g_return_if_fail (GTK_IS_LABEL (widget));
1611 label = GTK_LABEL (widget);
1613 /* We have to clear the layout, fonts etc. may have changed */
1614 gtk_label_clear_layout (label);
1618 gtk_label_direction_changed (GtkWidget *widget,
1619 GtkTextDirection previous_dir)
1621 GtkLabel *label = GTK_LABEL (widget);
1624 pango_layout_context_changed (label->layout);
1626 GTK_WIDGET_CLASS (parent_class)->direction_changed (widget, previous_dir);
1631 gtk_label_paint_word (GtkLabel *label,
1637 GtkWidget *widget = GTK_WIDGET (label);
1638 GtkLabelULine *uline;
1641 tmp_str = gdk_wcstombs (word->beginning);
1644 gtk_paint_string (widget->style, widget->window, widget->state,
1645 area, widget, "label",
1652 for (uline = word->uline; uline; uline = uline->next)
1653 gtk_paint_hline (widget->style, widget->window,
1654 widget->state, area,
1656 x + uline->x1, x + uline->x2, y + uline->y);
1661 get_layout_location (GtkLabel *label,
1670 misc = GTK_MISC (label);
1671 widget = GTK_WIDGET (label);
1673 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
1674 xalign = misc->xalign;
1676 xalign = 1.0 - misc->xalign;
1678 x = floor (widget->allocation.x + (gint)misc->xpad +
1679 xalign * (widget->allocation.width - widget->requisition.width)
1682 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
1683 x = MAX (x, widget->allocation.x + misc->xpad);
1686 widget->allocation.x + widget->allocation.width -
1687 widget->requisition.width - misc->xpad);
1689 y = floor (widget->allocation.y + (gint)misc->ypad
1690 + MAX (((widget->allocation.height - widget->requisition.height) * misc->yalign)
1701 gtk_label_draw_cursor (GtkLabel *label, gint xoffset, gint yoffset)
1703 if (label->select_info == NULL)
1706 if (GTK_WIDGET_DRAWABLE (label))
1708 GtkWidget *widget = GTK_WIDGET (label);
1710 GtkTextDirection keymap_direction;
1711 GtkTextDirection widget_direction;
1712 PangoRectangle strong_pos, weak_pos;
1713 gboolean split_cursor;
1714 PangoRectangle *cursor1 = NULL;
1715 PangoRectangle *cursor2 = NULL;
1716 GdkRectangle cursor_location;
1717 GtkTextDirection dir1 = GTK_TEXT_DIR_NONE;
1718 GtkTextDirection dir2 = GTK_TEXT_DIR_NONE;
1722 (gdk_keymap_get_direction (gdk_keymap_get_for_display (gtk_widget_get_display (widget))) == PANGO_DIRECTION_LTR) ?
1723 GTK_TEXT_DIR_LTR : GTK_TEXT_DIR_RTL;
1725 widget_direction = gtk_widget_get_direction (widget);
1727 gtk_label_ensure_layout (label);
1729 pango_layout_get_cursor_pos (label->layout, label->select_info->selection_end,
1730 &strong_pos, &weak_pos);
1732 g_object_get (gtk_widget_get_settings (widget),
1733 "gtk-split-cursor", &split_cursor,
1736 dir1 = widget_direction;
1740 cursor1 = &strong_pos;
1742 if (strong_pos.x != weak_pos.x ||
1743 strong_pos.y != weak_pos.y)
1745 dir2 = (widget_direction == GTK_TEXT_DIR_LTR) ? GTK_TEXT_DIR_RTL : GTK_TEXT_DIR_LTR;
1746 cursor2 = &weak_pos;
1751 if (keymap_direction == widget_direction)
1752 cursor1 = &strong_pos;
1754 cursor1 = &weak_pos;
1757 cursor_location.x = xoffset + PANGO_PIXELS (cursor1->x);
1758 cursor_location.y = yoffset + PANGO_PIXELS (cursor1->y);
1759 cursor_location.width = 0;
1760 cursor_location.height = PANGO_PIXELS (cursor1->height);
1762 gc = _gtk_get_insertion_cursor_gc (widget, TRUE);
1763 _gtk_draw_insertion_cursor (widget, widget->window, gc,
1764 &cursor_location, dir1,
1765 dir2 != GTK_TEXT_DIR_NONE);
1766 g_object_unref (gc);
1768 if (dir2 != GTK_TEXT_DIR_NONE)
1770 cursor_location.x = xoffset + PANGO_PIXELS (cursor2->x);
1771 cursor_location.y = yoffset + PANGO_PIXELS (cursor2->y);
1772 cursor_location.width = 0;
1773 cursor_location.height = PANGO_PIXELS (cursor2->height);
1775 gc = _gtk_get_insertion_cursor_gc (widget, FALSE);
1776 _gtk_draw_insertion_cursor (widget, widget->window, gc,
1777 &cursor_location, dir2, TRUE);
1778 g_object_unref (gc);
1785 gtk_label_expose (GtkWidget *widget,
1786 GdkEventExpose *event)
1791 g_return_val_if_fail (GTK_IS_LABEL (widget), FALSE);
1792 g_return_val_if_fail (event != NULL, FALSE);
1794 label = GTK_LABEL (widget);
1796 gtk_label_ensure_layout (label);
1798 if (GTK_WIDGET_VISIBLE (widget) && GTK_WIDGET_MAPPED (widget) &&
1799 label->text && (*label->text != '\0'))
1801 get_layout_location (label, &x, &y);
1803 gtk_paint_layout (widget->style,
1805 GTK_WIDGET_STATE (widget),
1813 if (label->select_info &&
1814 (label->select_info->selection_anchor !=
1815 label->select_info->selection_end))
1821 range[0] = label->select_info->selection_anchor;
1822 range[1] = label->select_info->selection_end;
1824 if (range[0] > range[1])
1826 gint tmp = range[0];
1827 range[0] = range[1];
1831 clip = gdk_pango_layout_get_clip_region (label->layout,
1836 /* FIXME should use gtk_paint, but it can't use a clip
1840 gdk_gc_set_clip_region (widget->style->black_gc, clip);
1843 state = GTK_STATE_SELECTED;
1844 if (!GTK_WIDGET_HAS_FOCUS (widget))
1845 state = GTK_STATE_ACTIVE;
1847 gdk_draw_layout_with_colors (widget->window,
1848 widget->style->black_gc,
1851 &widget->style->text[state],
1852 &widget->style->base[state]);
1854 gdk_gc_set_clip_region (widget->style->black_gc, NULL);
1855 gdk_region_destroy (clip);
1857 else if (label->select_info && GTK_WIDGET_HAS_FOCUS (widget))
1858 gtk_label_draw_cursor (label, x, y);
1865 gtk_label_set_uline_text_internal (GtkLabel *label,
1868 guint accel_key = GDK_VoidSymbol;
1873 gchar *dest, *pattern_dest;
1874 gboolean underscore;
1876 g_return_if_fail (GTK_IS_LABEL (label));
1877 g_return_if_fail (str != NULL);
1879 /* Split text into the base text and a separate pattern
1883 new_str = g_new (gchar, strlen (str) + 1);
1884 pattern = g_new (gchar, g_utf8_strlen (str, -1) + 1);
1893 pattern_dest = pattern;
1900 c = g_utf8_get_char (src);
1901 if (c == (gunichar)-1)
1903 g_warning ("Invalid input string");
1908 next_src = g_utf8_next_char (src);
1913 *pattern_dest++ = ' ';
1916 *pattern_dest++ = '_';
1917 if (accel_key == GDK_VoidSymbol)
1918 accel_key = gdk_keyval_to_lower (gdk_unicode_to_keyval (c));
1921 while (src < next_src)
1935 while (src < next_src)
1938 *pattern_dest++ = ' ';
1945 gtk_label_set_text_internal (label, new_str);
1946 gtk_label_set_pattern_internal (label, pattern);
1950 label->mnemonic_keyval = accel_key;
1954 gtk_label_parse_uline (GtkLabel *label,
1960 g_return_val_if_fail (GTK_IS_LABEL (label), GDK_VoidSymbol);
1961 g_return_val_if_fail (str != NULL, GDK_VoidSymbol);
1963 orig_keyval = label->mnemonic_keyval;
1965 g_object_freeze_notify (G_OBJECT (label));
1967 gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
1968 gtk_label_set_use_markup_internal (label, FALSE);
1969 gtk_label_set_use_underline_internal (label, TRUE);
1971 gtk_label_recalculate (label);
1973 keyval = label->mnemonic_keyval;
1974 label->mnemonic_keyval = GDK_VoidSymbol;
1976 gtk_label_setup_mnemonic (label, orig_keyval);
1978 g_object_thaw_notify (G_OBJECT (label));
1984 * gtk_label_set_text_with_mnemonic:
1985 * @label: a #GtkLabel
1988 * Sets the label's text from the string @str.
1989 * If characters in @str are preceded by an underscore, they are underlined
1990 * indicating that they represent a keyboard accelerator called a mnemonic.
1991 * The mnemonic key can be used to activate another widget, chosen automatically,
1992 * or explicitly using gtk_label_set_mnemonic_widget().
1995 gtk_label_set_text_with_mnemonic (GtkLabel *label,
2000 g_return_if_fail (GTK_IS_LABEL (label));
2001 g_return_if_fail (str != NULL);
2003 last_keyval = label->mnemonic_keyval;
2005 g_object_freeze_notify (G_OBJECT (label));
2007 gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
2008 gtk_label_set_use_markup_internal (label, FALSE);
2009 gtk_label_set_use_underline_internal (label, TRUE);
2011 gtk_label_recalculate (label);
2013 gtk_label_setup_mnemonic (label, last_keyval);
2015 g_object_thaw_notify (G_OBJECT (label));
2019 gtk_label_realize (GtkWidget *widget)
2023 label = GTK_LABEL (widget);
2025 (* GTK_WIDGET_CLASS (parent_class)->realize) (widget);
2027 if (label->select_info)
2028 gtk_label_create_window (label);
2032 gtk_label_unrealize (GtkWidget *widget)
2036 label = GTK_LABEL (widget);
2038 if (label->select_info)
2039 gtk_label_destroy_window (label);
2041 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
2045 gtk_label_map (GtkWidget *widget)
2049 label = GTK_LABEL (widget);
2051 (* GTK_WIDGET_CLASS (parent_class)->map) (widget);
2053 if (label->select_info)
2054 gdk_window_show (label->select_info->window);
2058 gtk_label_unmap (GtkWidget *widget)
2062 label = GTK_LABEL (widget);
2064 if (label->select_info)
2065 gdk_window_hide (label->select_info->window);
2067 (* GTK_WIDGET_CLASS (parent_class)->unmap) (widget);
2071 window_to_layout_coords (GtkLabel *label,
2078 widget = GTK_WIDGET (label);
2080 /* get layout location in widget->window coords */
2081 get_layout_location (label, &lx, &ly);
2085 *x += widget->allocation.x; /* go to widget->window */
2086 *x -= lx; /* go to layout */
2091 *y += widget->allocation.y; /* go to widget->window */
2092 *y -= ly; /* go to layout */
2098 layout_to_window_coords (GtkLabel *label,
2105 widget = GTK_WIDGET (label);
2107 /* get layout location in widget->window coords */
2108 get_layout_location (label, &lx, &ly);
2112 *x += lx; /* go to widget->window */
2113 *x -= widget->allocation.x; /* go to selection window */
2118 *y += ly; /* go to widget->window */
2119 *y -= widget->allocation.y; /* go to selection window */
2125 get_layout_index (GtkLabel *label,
2131 const gchar *cluster;
2132 const gchar *cluster_end;
2136 gtk_label_ensure_layout (label);
2138 window_to_layout_coords (label, &x, &y);
2143 pango_layout_xy_to_index (label->layout,
2148 cluster = label->text + *index;
2149 cluster_end = cluster;
2152 cluster_end = g_utf8_next_char (cluster_end);
2156 *index += (cluster_end - cluster);
2160 gtk_label_select_word (GtkLabel *label)
2164 gint start_index = gtk_label_move_backward_word (label, label->select_info->selection_end);
2165 gint end_index = gtk_label_move_forward_word (label, label->select_info->selection_end);
2167 min = MIN (label->select_info->selection_anchor,
2168 label->select_info->selection_end);
2169 max = MAX (label->select_info->selection_anchor,
2170 label->select_info->selection_end);
2172 min = MIN (min, start_index);
2173 max = MAX (max, end_index);
2175 gtk_label_select_region_index (label, min, max);
2179 gtk_label_button_press (GtkWidget *widget,
2180 GdkEventButton *event)
2185 label = GTK_LABEL (widget);
2187 if (label->select_info == NULL)
2190 if (event->button == 1)
2192 if (!GTK_WIDGET_HAS_FOCUS (widget))
2193 gtk_widget_grab_focus (widget);
2195 if (event->type == GDK_3BUTTON_PRESS)
2197 gtk_label_select_region_index (label, 0, strlen (label->text));
2201 if (event->type == GDK_2BUTTON_PRESS)
2203 gtk_label_select_word (label);
2207 get_layout_index (label, event->x, event->y, &index);
2209 if ((label->select_info->selection_anchor !=
2210 label->select_info->selection_end) &&
2211 (event->state & GDK_SHIFT_MASK))
2215 /* extend (same as motion) */
2216 min = MIN (label->select_info->selection_anchor,
2217 label->select_info->selection_end);
2218 max = MAX (label->select_info->selection_anchor,
2219 label->select_info->selection_end);
2221 min = MIN (min, index);
2222 max = MAX (max, index);
2224 /* ensure the anchor is opposite index */
2232 gtk_label_select_region_index (label, min, max);
2236 if (event->type == GDK_3BUTTON_PRESS)
2237 gtk_label_select_region_index (label, 0, strlen (label->text));
2238 else if (event->type == GDK_2BUTTON_PRESS)
2239 gtk_label_select_word (label);
2241 /* start a replacement */
2242 gtk_label_select_region_index (label, index, index);
2247 else if (event->button == 3 && event->type == GDK_BUTTON_PRESS)
2249 gtk_label_do_popup (label, event);
2258 gtk_label_button_release (GtkWidget *widget,
2259 GdkEventButton *event)
2264 label = GTK_LABEL (widget);
2266 if (label->select_info == NULL)
2269 if (event->button != 1)
2272 /* The goal here is to return TRUE iff we ate the
2273 * button press to start selecting.
2280 gtk_label_motion (GtkWidget *widget,
2281 GdkEventMotion *event)
2287 label = GTK_LABEL (widget);
2289 if (label->select_info == NULL)
2292 if ((event->state & GDK_BUTTON1_MASK) == 0)
2295 gdk_window_get_pointer (label->select_info->window,
2298 get_layout_index (label, x, y, &index);
2300 gtk_label_select_region_index (label,
2301 label->select_info->selection_anchor,
2308 gtk_label_create_window (GtkLabel *label)
2311 GdkWindowAttr attributes;
2312 gint attributes_mask;
2314 g_assert (label->select_info);
2315 g_assert (GTK_WIDGET_REALIZED (label));
2317 if (label->select_info->window)
2320 widget = GTK_WIDGET (label);
2322 attributes.x = widget->allocation.x;
2323 attributes.y = widget->allocation.y;
2324 attributes.width = widget->allocation.width;
2325 attributes.height = widget->allocation.height;
2326 attributes.window_type = GDK_WINDOW_TEMP;
2327 attributes.wclass = GDK_INPUT_ONLY;
2328 attributes.override_redirect = TRUE;
2329 attributes.cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget),
2331 attributes.event_mask = gtk_widget_get_events (widget) |
2332 GDK_BUTTON_PRESS_MASK |
2333 GDK_BUTTON_RELEASE_MASK |
2334 GDK_BUTTON_MOTION_MASK;
2336 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_NOREDIR | GDK_WA_CURSOR;
2338 label->select_info->window = gdk_window_new (widget->window,
2339 &attributes, attributes_mask);
2340 gdk_window_set_user_data (label->select_info->window, widget);
2342 gdk_cursor_unref (attributes.cursor);
2346 gtk_label_destroy_window (GtkLabel *label)
2348 g_assert (label->select_info);
2350 if (label->select_info->window == NULL)
2353 gdk_window_set_user_data (label->select_info->window, NULL);
2354 gdk_window_destroy (label->select_info->window);
2355 label->select_info->window = NULL;
2359 * gtk_label_set_selectable:
2360 * @label: a #GtkLabel
2361 * @setting: %TRUE to allow selecting text in the label
2363 * Selectable labels allow the user to select text from the label, for
2368 gtk_label_set_selectable (GtkLabel *label,
2371 gboolean old_setting;
2373 g_return_if_fail (GTK_IS_LABEL (label));
2375 setting = setting != FALSE;
2376 old_setting = label->select_info != NULL;
2380 if (label->select_info == NULL)
2382 label->select_info = g_new0 (GtkLabelSelectionInfo, 1);
2384 GTK_WIDGET_SET_FLAGS (label, GTK_CAN_FOCUS);
2386 if (GTK_WIDGET_REALIZED (label))
2387 gtk_label_create_window (label);
2389 if (GTK_WIDGET_MAPPED (label))
2390 gdk_window_show (label->select_info->window);
2395 if (label->select_info)
2397 /* unselect, to give up the selection */
2398 gtk_label_select_region (label, 0, 0);
2400 if (label->select_info->window)
2402 gtk_label_destroy_window (label);
2405 g_free (label->select_info);
2407 label->select_info = NULL;
2409 GTK_WIDGET_UNSET_FLAGS (label, GTK_CAN_FOCUS);
2412 if (setting != old_setting)
2414 g_object_freeze_notify (G_OBJECT (label));
2415 g_object_notify (G_OBJECT (label), "selectable");
2416 g_object_notify (G_OBJECT (label), "cursor_position");
2417 g_object_notify (G_OBJECT (label), "selection_bound");
2418 g_object_thaw_notify (G_OBJECT (label));
2419 gtk_widget_queue_draw (GTK_WIDGET (label));
2424 * gtk_label_get_selectable:
2425 * @label: a #GtkLabel
2427 * Gets the value set by gtk_label_set_selectable().
2429 * Return value: %TRUE if the user can copy text from the label
2432 gtk_label_get_selectable (GtkLabel *label)
2434 g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
2436 return label->select_info != NULL;
2440 get_text_callback (GtkClipboard *clipboard,
2441 GtkSelectionData *selection_data,
2443 gpointer user_data_or_owner)
2447 label = GTK_LABEL (user_data_or_owner);
2449 if ((label->select_info->selection_anchor !=
2450 label->select_info->selection_end) &&
2456 start = MIN (label->select_info->selection_anchor,
2457 label->select_info->selection_end);
2458 end = MAX (label->select_info->selection_anchor,
2459 label->select_info->selection_end);
2461 len = strlen (label->text);
2469 gtk_selection_data_set_text (selection_data,
2470 label->text + start,
2476 clear_text_callback (GtkClipboard *clipboard,
2477 gpointer user_data_or_owner)
2481 label = GTK_LABEL (user_data_or_owner);
2483 if (label->select_info)
2485 label->select_info->selection_anchor = label->select_info->selection_end;
2487 gtk_widget_queue_draw (GTK_WIDGET (label));
2492 gtk_label_select_region_index (GtkLabel *label,
2496 static const GtkTargetEntry targets[] = {
2499 { "COMPOUND_TEXT", 0, 0 },
2500 { "UTF8_STRING", 0, 0 }
2503 g_return_if_fail (GTK_IS_LABEL (label));
2505 if (label->select_info)
2507 GtkClipboard *clipboard;
2509 if (label->select_info->selection_anchor == anchor_index &&
2510 label->select_info->selection_end == end_index)
2513 label->select_info->selection_anchor = anchor_index;
2514 label->select_info->selection_end = end_index;
2516 clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label),
2517 GDK_SELECTION_PRIMARY);
2519 if (anchor_index != end_index)
2521 gtk_clipboard_set_with_owner (clipboard,
2523 G_N_ELEMENTS (targets),
2525 clear_text_callback,
2530 if (gtk_clipboard_get_owner (clipboard) == G_OBJECT (label))
2531 gtk_clipboard_clear (clipboard);
2534 gtk_widget_queue_draw (GTK_WIDGET (label));
2536 g_object_freeze_notify (G_OBJECT (label));
2537 g_object_notify (G_OBJECT (label), "cursor_position");
2538 g_object_notify (G_OBJECT (label), "selection_bound");
2539 g_object_thaw_notify (G_OBJECT (label));
2544 * gtk_label_select_region:
2545 * @label: a #GtkLabel
2546 * @start_offset: start offset (in characters not bytes)
2547 * @end_offset: end offset (in characters not bytes)
2549 * Selects a range of characters in the label, if the label is selectable.
2550 * See gtk_label_set_selectable(). If the label is not selectable,
2551 * this function has no effect. If @start_offset or
2552 * @end_offset are -1, then the end of the label will be substituted.
2556 gtk_label_select_region (GtkLabel *label,
2560 g_return_if_fail (GTK_IS_LABEL (label));
2562 if (label->text && label->select_info)
2564 if (start_offset < 0)
2565 start_offset = g_utf8_strlen (label->text, -1);
2568 end_offset = g_utf8_strlen (label->text, -1);
2570 gtk_label_select_region_index (label,
2571 g_utf8_offset_to_pointer (label->text, start_offset) - label->text,
2572 g_utf8_offset_to_pointer (label->text, end_offset) - label->text);
2577 * gtk_label_get_selection_bounds:
2578 * @label: a #GtkLabel
2579 * @start: return location for start of selection, as a character offset
2580 * @end: return location for end of selection, as a character offset
2582 * Gets the selected range of characters in the label, returning %TRUE
2583 * if there's a selection.
2585 * Return value: %TRUE if selection is non-empty
2588 gtk_label_get_selection_bounds (GtkLabel *label,
2592 g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
2594 if (label->select_info == NULL)
2596 /* not a selectable label */
2606 gint start_index, end_index;
2607 gint start_offset, end_offset;
2610 start_index = MIN (label->select_info->selection_anchor,
2611 label->select_info->selection_end);
2612 end_index = MAX (label->select_info->selection_anchor,
2613 label->select_info->selection_end);
2615 len = strlen (label->text);
2617 if (end_index > len)
2620 if (start_index > len)
2623 start_offset = g_utf8_strlen (label->text, start_index);
2624 end_offset = g_utf8_strlen (label->text, end_index);
2626 if (start_offset > end_offset)
2628 gint tmp = start_offset;
2629 start_offset = end_offset;
2634 *start = start_offset;
2639 return start_offset != end_offset;
2645 * gtk_label_get_layout:
2646 * @label: a #GtkLabel
2648 * Gets the #PangoLayout used to display the label.
2649 * The layout is useful to e.g. convert text positions to
2650 * pixel positions, in combination with gtk_label_get_layout_offsets().
2651 * The returned layout is owned by the label so need not be
2652 * freed by the caller.
2654 * Return value: the #PangoLayout for this label
2657 gtk_label_get_layout (GtkLabel *label)
2659 g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
2661 gtk_label_ensure_layout (label);
2663 return label->layout;
2667 * gtk_label_get_layout_offsets:
2668 * @label: a #GtkLabel
2669 * @x: location to store X offset of layout, or %NULL
2670 * @y: location to store Y offset of layout, or %NULL
2672 * Obtains the coordinates where the label will draw the #PangoLayout
2673 * representing the text in the label; useful to convert mouse events
2674 * into coordinates inside the #PangoLayout, e.g. to take some action
2675 * if some part of the label is clicked. Of course you will need to
2676 * create a #GtkEventBox to receive the events, and pack the label
2677 * inside it, since labels are a #GTK_NO_WINDOW widget. Remember
2678 * when using the #PangoLayout functions you need to convert to
2679 * and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
2683 gtk_label_get_layout_offsets (GtkLabel *label,
2687 g_return_if_fail (GTK_IS_LABEL (label));
2689 get_layout_location (label, x, y);
2693 * gtk_label_set_use_markup:
2694 * @label: a #GtkLabel
2695 * @setting: %TRUE if the label's text should be parsed for markup.
2697 * Sets whether the text of the label contains markup in <link
2698 * linkend="PangoMarkupFormat">Pango's text markup
2699 * language</link>. See gtk_label_set_markup().
2702 gtk_label_set_use_markup (GtkLabel *label,
2705 g_return_if_fail (GTK_IS_LABEL (label));
2707 gtk_label_set_use_markup_internal (label, setting);
2708 gtk_label_recalculate (label);
2712 * gtk_label_get_use_markup:
2713 * @label: a #GtkLabel
2715 * Returns whether the label's text is interpreted as marked up with
2716 * the <link linkend="PangoMarkupFormat">Pango text markup
2717 * language</link>. See gtk_label_set_use_markup ().
2719 * Return value: %TRUE if the label's text will be parsed for markup.
2722 gtk_label_get_use_markup (GtkLabel *label)
2724 g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
2726 return label->use_markup;
2730 * gtk_label_set_use_underline:
2731 * @label: a #GtkLabel
2732 * @setting: %TRUE if underlines in the text indicate mnemonics
2734 * If true, an underline in the text indicates the next character should be
2735 * used for the mnemonic accelerator key.
2738 gtk_label_set_use_underline (GtkLabel *label,
2741 g_return_if_fail (GTK_IS_LABEL (label));
2743 gtk_label_set_use_underline_internal (label, setting);
2744 gtk_label_recalculate (label);
2745 if (label->use_underline)
2746 gtk_label_setup_mnemonic (label, label->mnemonic_keyval);
2750 * gtk_label_get_use_underline:
2751 * @label: a #GtkLabel
2753 * Returns whether an embedded underline in the label indicates a
2754 * mnemonic. See gtk_label_set_use_underline ().
2756 * Return value: %TRUE whether an embedded underline in the label indicates
2757 * the mnemonic accelerator keys.
2760 gtk_label_get_use_underline (GtkLabel *label)
2762 g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
2764 return label->use_underline;
2768 gtk_label_focus (GtkWidget *widget,
2769 GtkDirectionType direction)
2771 /* We never want to be in the tab chain */
2775 /* Compute the X position for an offset that corresponds to the "more important
2776 * cursor position for that offset. We use this when trying to guess to which
2777 * end of the selection we should go to when the user hits the left or
2781 get_better_cursor (GtkLabel *label,
2786 GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
2787 GtkTextDirection keymap_direction =
2788 (gdk_keymap_get_direction (keymap) == PANGO_DIRECTION_LTR) ?
2789 GTK_TEXT_DIR_LTR : GTK_TEXT_DIR_RTL;
2790 GtkTextDirection widget_direction = gtk_widget_get_direction (GTK_WIDGET (label));
2791 gboolean split_cursor;
2792 PangoRectangle strong_pos, weak_pos;
2794 g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
2795 "gtk-split-cursor", &split_cursor,
2798 gtk_label_ensure_layout (label);
2800 pango_layout_get_cursor_pos (label->layout, index,
2801 &strong_pos, &weak_pos);
2805 *x = strong_pos.x / PANGO_SCALE;
2806 *y = strong_pos.y / PANGO_SCALE;
2810 if (keymap_direction == widget_direction)
2812 *x = strong_pos.x / PANGO_SCALE;
2813 *y = strong_pos.y / PANGO_SCALE;
2817 *x = weak_pos.x / PANGO_SCALE;
2818 *y = weak_pos.y / PANGO_SCALE;
2825 gtk_label_move_logically (GtkLabel *label,
2829 gint offset = g_utf8_pointer_to_offset (label->text,
2830 label->text + start);
2834 PangoLogAttr *log_attrs;
2838 gtk_label_ensure_layout (label);
2840 length = g_utf8_strlen (label->text, -1);
2842 pango_layout_get_log_attrs (label->layout, &log_attrs, &n_attrs);
2844 while (count > 0 && offset < length)
2848 while (offset < length && !log_attrs[offset].is_cursor_position);
2852 while (count < 0 && offset > 0)
2856 while (offset > 0 && !log_attrs[offset].is_cursor_position);
2864 return g_utf8_offset_to_pointer (label->text, offset) - label->text;
2868 gtk_label_move_visually (GtkLabel *label,
2878 int new_index, new_trailing;
2879 gboolean split_cursor;
2882 gtk_label_ensure_layout (label);
2884 g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
2885 "gtk-split-cursor", &split_cursor,
2892 GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
2893 GtkTextDirection keymap_direction =
2894 (gdk_keymap_get_direction (keymap) == PANGO_DIRECTION_LTR) ?
2895 GTK_TEXT_DIR_LTR : GTK_TEXT_DIR_RTL;
2897 strong = keymap_direction == gtk_widget_get_direction (GTK_WIDGET (label));
2902 pango_layout_move_cursor_visually (label->layout, strong, index, 0, 1, &new_index, &new_trailing);
2907 pango_layout_move_cursor_visually (label->layout, strong, index, 0, -1, &new_index, &new_trailing);
2911 if (new_index < 0 || new_index == G_MAXINT)
2916 while (new_trailing--)
2917 index = g_utf8_next_char (label->text + new_index) - label->text;
2924 gtk_label_move_forward_word (GtkLabel *label,
2927 gint new_pos = g_utf8_pointer_to_offset (label->text,
2928 label->text + start);
2931 length = g_utf8_strlen (label->text, -1);
2932 if (new_pos < length)
2934 PangoLogAttr *log_attrs;
2937 gtk_label_ensure_layout (label);
2939 pango_layout_get_log_attrs (label->layout, &log_attrs, &n_attrs);
2941 /* Find the next word end */
2943 while (new_pos < n_attrs && !log_attrs[new_pos].is_word_end)
2949 return g_utf8_offset_to_pointer (label->text, new_pos) - label->text;
2954 gtk_label_move_backward_word (GtkLabel *label,
2957 gint new_pos = g_utf8_pointer_to_offset (label->text,
2958 label->text + start);
2961 length = g_utf8_strlen (label->text, -1);
2965 PangoLogAttr *log_attrs;
2968 gtk_label_ensure_layout (label);
2970 pango_layout_get_log_attrs (label->layout, &log_attrs, &n_attrs);
2974 /* Find the previous word beginning */
2975 while (new_pos > 0 && !log_attrs[new_pos].is_word_start)
2981 return g_utf8_offset_to_pointer (label->text, new_pos) - label->text;
2985 gtk_label_move_cursor (GtkLabel *label,
2986 GtkMovementStep step,
2988 gboolean extend_selection)
2992 if (label->select_info == NULL)
2995 new_pos = label->select_info->selection_end;
2997 if (label->select_info->selection_end != label->select_info->selection_anchor &&
3000 /* If we have a current selection and aren't extending it, move to the
3001 * start/or end of the selection as appropriate
3005 case GTK_MOVEMENT_VISUAL_POSITIONS:
3008 gint anchor_x, anchor_y;
3009 gboolean end_is_left;
3011 get_better_cursor (label, label->select_info->selection_end, &end_x, &end_y);
3012 get_better_cursor (label, label->select_info->selection_anchor, &anchor_x, &anchor_y);
3014 end_is_left = (end_y < anchor_y) || (end_y == anchor_y && end_x < anchor_x);
3017 new_pos = end_is_left ? label->select_info->selection_end : label->select_info->selection_anchor;
3019 new_pos = !end_is_left ? label->select_info->selection_end : label->select_info->selection_anchor;
3023 case GTK_MOVEMENT_LOGICAL_POSITIONS:
3024 case GTK_MOVEMENT_WORDS:
3026 new_pos = MIN (label->select_info->selection_end, label->select_info->selection_anchor);
3028 new_pos = MAX (label->select_info->selection_end, label->select_info->selection_anchor);
3030 case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
3031 case GTK_MOVEMENT_PARAGRAPH_ENDS:
3032 case GTK_MOVEMENT_BUFFER_ENDS:
3033 /* FIXME: Can do better here */
3034 new_pos = count < 0 ? 0 : strlen (label->text);
3036 case GTK_MOVEMENT_DISPLAY_LINES:
3037 case GTK_MOVEMENT_PARAGRAPHS:
3038 case GTK_MOVEMENT_PAGES:
3046 case GTK_MOVEMENT_LOGICAL_POSITIONS:
3047 new_pos = gtk_label_move_logically (label, new_pos, count);
3049 case GTK_MOVEMENT_VISUAL_POSITIONS:
3050 new_pos = gtk_label_move_visually (label, new_pos, count);
3052 case GTK_MOVEMENT_WORDS:
3055 new_pos = gtk_label_move_forward_word (label, new_pos);
3060 new_pos = gtk_label_move_backward_word (label, new_pos);
3064 case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
3065 case GTK_MOVEMENT_PARAGRAPH_ENDS:
3066 case GTK_MOVEMENT_BUFFER_ENDS:
3067 /* FIXME: Can do better here */
3068 new_pos = count < 0 ? 0 : strlen (label->text);
3070 case GTK_MOVEMENT_DISPLAY_LINES:
3071 case GTK_MOVEMENT_PARAGRAPHS:
3072 case GTK_MOVEMENT_PAGES:
3077 if (extend_selection)
3078 gtk_label_select_region_index (label,
3079 label->select_info->selection_anchor,
3082 gtk_label_select_region_index (label, new_pos, new_pos);
3086 gtk_label_copy_clipboard (GtkLabel *label)
3088 if (label->text && label->select_info)
3093 start = MIN (label->select_info->selection_anchor,
3094 label->select_info->selection_end);
3095 end = MAX (label->select_info->selection_anchor,
3096 label->select_info->selection_end);
3098 len = strlen (label->text);
3107 gtk_clipboard_set_text (gtk_widget_get_clipboard (GTK_WIDGET (label),
3108 GDK_SELECTION_CLIPBOARD),
3109 label->text + start, end - start);
3114 gtk_label_select_all (GtkLabel *label)
3116 gtk_label_select_region_index (label, 0, strlen (label->text));
3119 /* Quick hack of a popup menu
3122 activate_cb (GtkWidget *menuitem,
3125 const gchar *signal = g_object_get_data (G_OBJECT (menuitem), "gtk-signal");
3126 g_signal_emit_by_name (label, signal);
3130 append_action_signal (GtkLabel *label,
3132 const gchar *stock_id,
3133 const gchar *signal,
3136 GtkWidget *menuitem = gtk_image_menu_item_new_from_stock (stock_id, NULL);
3138 g_object_set_data (G_OBJECT (menuitem), "gtk-signal", (char *)signal);
3139 g_signal_connect (menuitem, "activate",
3140 G_CALLBACK (activate_cb), label);
3142 gtk_widget_set_sensitive (menuitem, sensitive);
3144 gtk_widget_show (menuitem);
3145 gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
3149 popup_menu_detach (GtkWidget *attach_widget,
3153 label = GTK_LABEL (attach_widget);
3155 if (label->select_info)
3156 label->select_info->popup_menu = NULL;
3160 popup_position_func (GtkMenu *menu,
3171 label = GTK_LABEL (user_data);
3172 widget = GTK_WIDGET (label);
3174 if (label->select_info == NULL)
3177 g_return_if_fail (GTK_WIDGET_REALIZED (label));
3179 screen = gtk_widget_get_screen (widget);
3180 gdk_window_get_origin (widget->window, x, y);
3182 gtk_widget_size_request (label->select_info->popup_menu, &req);
3184 *x += widget->allocation.width / 2;
3185 *y += widget->allocation.height;
3187 *x = CLAMP (*x, 0, MAX (0, gdk_screen_get_width (screen) - req.width));
3188 *y = CLAMP (*y, 0, MAX (0, gdk_screen_get_height (screen) - req.height));
3193 gtk_label_do_popup (GtkLabel *label,
3194 GdkEventButton *event)
3196 GtkWidget *menuitem;
3197 gboolean have_selection;
3199 if (label->select_info == NULL)
3202 if (label->select_info->popup_menu)
3203 gtk_widget_destroy (label->select_info->popup_menu);
3205 label->select_info->popup_menu = gtk_menu_new ();
3207 gtk_menu_attach_to_widget (GTK_MENU (label->select_info->popup_menu),
3212 label->select_info->selection_anchor != label->select_info->selection_end;
3215 append_action_signal (label, label->select_info->popup_menu, GTK_STOCK_CUT, "cut_clipboard",
3217 append_action_signal (label, label->select_info->popup_menu, GTK_STOCK_COPY, "copy_clipboard",
3219 append_action_signal (label, label->select_info->popup_menu, GTK_STOCK_PASTE, "paste_clipboard",
3222 menuitem = gtk_menu_item_new_with_label (_("Select All"));
3223 g_signal_connect_swapped (menuitem, "activate",
3224 G_CALLBACK (gtk_label_select_all), label);
3225 gtk_widget_show (menuitem);
3226 gtk_menu_shell_append (GTK_MENU_SHELL (label->select_info->popup_menu), menuitem);
3228 menuitem = gtk_separator_menu_item_new ();
3229 gtk_widget_show (menuitem);
3230 gtk_menu_shell_append (GTK_MENU_SHELL (label->select_info->popup_menu), menuitem);
3232 menuitem = gtk_menu_item_new_with_label (_("Input Methods"));
3233 gtk_widget_show (menuitem);
3234 gtk_menu_item_set_submenu (GTK_MENU_ITEM (menuitem), gtk_menu_new ());
3235 gtk_widget_set_sensitive (menuitem, FALSE);
3236 gtk_menu_shell_append (GTK_MENU_SHELL (label->select_info->popup_menu), menuitem);
3238 g_signal_emit (label,
3239 signals[POPULATE_POPUP],
3241 label->select_info->popup_menu);
3244 gtk_menu_popup (GTK_MENU (label->select_info->popup_menu), NULL, NULL,
3246 event->button, event->time);
3248 gtk_menu_popup (GTK_MENU (label->select_info->popup_menu), NULL, NULL,
3249 popup_position_func, label,
3250 0, gtk_get_current_event_time ());