Pileus Git - ~andy/gtk/blob - gtk/gtklabel.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   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.
   8  *
   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.
  13  *
  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.
  17  */
  18
  19 /*
  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/.
  24  */
  25
  26 #include "config.h"
  27
  28 #include <math.h>
  29 #include <string.h>
  30
  31 #include "gtklabel.h"
  32 #include "gtkaccellabel.h"
  33 #include "gtkdnd.h"
  34 #include "gtkmainprivate.h"
  35 #include "gtkmarshalers.h"
  36 #include "gtkpango.h"
  37 #include "gtkwindow.h"
  38 #include "gtkclipboard.h"
  39 #include "gtkimagemenuitem.h"
  40 #include "gtkintl.h"
  41 #include "gtkseparatormenuitem.h"
  42 #include "gtktextutil.h"
  43 #include "gtkmenuitem.h"
  44 #include "gtkmenushellprivate.h"
  45 #include "gtknotebook.h"
  46 #include "gtkstock.h"
  47 #include "gtkbindings.h"
  48 #include "gtkbuildable.h"
  49 #include "gtkimage.h"
  50 #include "gtkshow.h"
  51 #include "gtktooltip.h"
  52 #include "gtkprivate.h"
  53 #include "gtktypebuiltins.h"
  54
  55
  56 /**
  57  * SECTION:gtklabel
  58  * @Short_description: A widget that displays a small to medium amount of text
  59  * @Title: GtkLabel
  60  *
  61  * The #GtkLabel widget displays a small amount of text. As the name
  62  * implies, most labels are used to label another widget such as a
  63  * #GtkButton, a #GtkMenuItem, or a #GtkOptionMenu.
  64  *
  65  * <refsect2 id="GtkLabel-BUILDER-UI">
  66  * <title>GtkLabel as GtkBuildable</title>
  67  * <para>
  68  * The GtkLabel implementation of the GtkBuildable interface supports a
  69  * custom &lt;attributes&gt; element, which supports any number of &lt;attribute&gt;
  70  * elements. the &lt;attribute&gt; element has attributes named name, value,
  71  * start and end and allows you to specify #PangoAttribute values for this label.
  72  *
  73  * <example>
  74  * <title>A UI definition fragment specifying Pango attributes</title>
  75  * <programlisting><![CDATA[
  76  * <object class="GtkLabel">
  77  *   <attributes>
  78  *     <attribute name="weight" value="PANGO_WEIGHT_BOLD"/>
  79  *     <attribute name="background" value="red" start="5" end="10"/>"
  80  *   </attributes>
  81  * </object>
  82  * ]]></programlisting>
  83  * </example>
  84  * The start and end attributes specify the range of characters to which the
  85  * Pango attribute applies. If start and end are not specified, the attribute is
  86  * applied to the whole text. Note that specifying ranges does not make much
  87  * sense with translatable attributes. Use markup embedded in the translatable
  88  * content instead.
  89  * </para>
  90  * </refsect2>
  91  * <refsect2>
  92  * <title>Mnemonics</title>
  93  * <para>
  94  * Labels may contain <firstterm>mnemonics</firstterm>. Mnemonics are
  95  * underlined characters in the label, used for keyboard navigation.
  96  * Mnemonics are created by providing a string with an underscore before
  97  * the mnemonic character, such as <literal>"_File"</literal>, to the
  98  * functions gtk_label_new_with_mnemonic() or
  99  * gtk_label_set_text_with_mnemonic().
 100  *
 101  * Mnemonics automatically activate any activatable widget the label is
 102  * inside, such as a #GtkButton; if the label is not inside the
 103  * mnemonic's target widget, you have to tell the label about the target
 104  * using gtk_label_set_mnemonic_widget(). Here's a simple example where
 105  * the label is inside a button:
 106  *
 107  * <informalexample>
 108  * <programlisting>
 109  *   // Pressing Alt+H will activate this button
 110  *   button = gtk_button_new (<!-- -->);
 111  *   label = gtk_label_new_with_mnemonic ("_Hello");
 112  *   gtk_container_add (GTK_CONTAINER (button), label);
 113  * </programlisting>
 114  * </informalexample>
 115  *
 116  * There's a convenience function to create buttons with a mnemonic label
 117  * already inside:
 118  *
 119  * <informalexample>
 120  * <programlisting>
 121  *   // Pressing Alt+H will activate this button
 122  *   button = gtk_button_new_with_mnemonic ("_Hello");
 123  * </programlisting>
 124  * </informalexample>
 125  *
 126  * To create a mnemonic for a widget alongside the label, such as a
 127  * #GtkEntry, you have to point the label at the entry with
 128  * gtk_label_set_mnemonic_widget():
 129  *
 130  * <informalexample>
 131  * <programlisting>
 132  *   // Pressing Alt+H will focus the entry
 133  *   entry = gtk_entry_new (<!-- -->);
 134  *   label = gtk_label_new_with_mnemonic ("_Hello");
 135  *   gtk_label_set_mnemonic_widget (GTK_LABEL (label), entry);
 136  * </programlisting>
 137  * </informalexample>
 138  * </para>
 139  * </refsect2>
 140  * <refsect2>
 141  * <title>Markup (styled text)</title>
 142  * <para>
 143  * To make it easy to format text in a label (changing colors, fonts,
 144  * etc.), label text can be provided in a simple <link
 145  * linkend="PangoMarkupFormat">markup format</link>.
 146  * Here's how to create a label with a small font:
 147  *
 148  * <informalexample>
 149  * <programlisting>
 150  *   label = gtk_label_new (NULL);
 151  *   gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>");
 152  * </programlisting>
 153  * </informalexample>
 154  *
 155  * (See <link
 156  * linkend="PangoMarkupFormat">complete documentation</link> of available
 157  * tags in the Pango manual.)
 158  *
 159  * The markup passed to gtk_label_set_markup() must be valid; for example,
 160  * literal &lt;, &gt; and &amp; characters must be escaped as \&lt;,
 161  * \gt;, and \&amp;. If you pass text obtained from the user, file,
 162  * or a network to gtk_label_set_markup(), you'll want to escape it with
 163  * g_markup_escape_text() or g_markup_printf_escaped().
 164  *
 165  * Markup strings are just a convenient way to set the #PangoAttrList on
 166  * a label; gtk_label_set_attributes() may be a simpler way to set
 167  * attributes in some cases. Be careful though; #PangoAttrList tends to
 168  * cause internationalization problems, unless you're applying attributes
 169  * to the entire string (i.e. unless you set the range of each attribute
 170  * to [0, %G_MAXINT)). The reason is that specifying the start_index and
 171  * end_index for a #PangoAttribute requires knowledge of the exact string
 172  * being displayed, so translations will cause problems.
 173  * </para>
 174  * </refsect2>
 175  * <refsect2>
 176  * <title>Selectable labels</title>
 177  * Labels can be made selectable with gtk_label_set_selectable().
 178  * Selectable labels allow the user to copy the label contents to
 179  * the clipboard. Only labels that contain useful-to-copy information
 180  * &mdash; such as error messages &mdash; should be made selectable.
 181  * </refsect2>
 182  * <refsect2 id="label-text-layout">
 183  * <title>Text layout</title>
 184  * <para>
 185  * A label can contain any number of paragraphs, but will have
 186  * performance problems if it contains more than a small number.
 187  * Paragraphs are separated by newlines or other paragraph separators
 188  * understood by Pango.
 189  *
 190  * Labels can automatically wrap text if you call
 191  * gtk_label_set_line_wrap().
 192  *
 193  * gtk_label_set_justify() sets how the lines in a label align
 194  * with one another. If you want to set how the label as a whole
 195  * aligns in its available space, see gtk_misc_set_alignment().
 196  *
 197  * The #GtkLabel:width-chars and #GtkLabel:max-width-chars properties
 198  * can be used to control the size allocation of ellipsized or wrapped
 199  * labels. For ellipsizing labels, if either is specified (and less
 200  * than the actual text size), it is used as the minimum width, and the actual
 201  * text size is used as the natural width of the label. For wrapping labels,
 202  * width-chars is used as the minimum width, if specified, and max-width-chars
 203  * is used as the natural width. Even if max-width-chars specified, wrapping
 204  * labels will be rewrapped to use all of the available width.
 205  *
 206  * <note><para>
 207  * Note that the interpretation of #GtkLabel:width-chars and
 208  * #GtkLabel:max-width-chars has changed a bit with the introduction of
 209  * <link linkend="geometry-management">width-for-height geometry management.</link>
 210  * </para></note>
 211  * </para>
 212  * </refsect2>
 213  * <refsect2>
 214  * <title>Links</title>
 215  * <para>
 216  * Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
 217  * to regular Pango markup. The markup for links is borrowed from HTML, using the
 218  * <tag>a</tag> with href and title attributes. GTK+ renders links similar to the
 219  * way they appear in web browsers, with colored, underlined text. The title
 220  * attribute is displayed as a tooltip on the link. An example looks like this:
 221  *
 222  * <informalexample><programlisting>
 223  * gtk_label_set_markup (label, "Go to the <a href="http://www.gtk.org" title="&lt;i&gt;Our&lt;/i&gt; website">GTK+ website</a> for more...");
 224  * </programlisting></informalexample>
 225  *
 226  * It is possible to implement custom handling for links and their tooltips with
 227  * the #GtkLabel::activate-link signal and the gtk_label_get_current_uri() function.
 228  * </para>
 229  * </refsect2>
 230  */
 231
 232
 233 /*rint() is only available in GCC and/or C99*/
 234 #if (__STDC_VERSION__ < 199901L && !defined __GNUC__)
 235 double rint(double x)
 236 {
 237         if (ceil(x+0.5) == floor(x+0.5))
 238         {
 239                 int a = (int)ceil(x);
 240                 if (a%2 == 0)
 241                         return ceil(x);
 242                 else
 243                         return floor(x);
 244         }
 245         else
 246                 return floor(x+0.5);
 247 }
 248 #endif
 249
 250
 251
 252 struct _GtkLabelPrivate
 253 {
 254   GtkLabelSelectionInfo *select_info;
 255   GtkWidget *mnemonic_widget;
 256   GtkWindow *mnemonic_window;
 257
 258   PangoAttrList *attrs;
 259   PangoAttrList *effective_attrs;
 260   PangoLayout   *layout;
 261
 262   gchar   *label;
 263   gchar   *text;
 264
 265   gdouble  angle;
 266
 267   guint     mnemonics_visible : 1;
 268   guint    jtype              : 2;
 269   guint    wrap               : 1;
 270   guint    use_underline      : 1;
 271   guint    use_markup         : 1;
 272   guint    ellipsize          : 3;
 273   guint    single_line_mode   : 1;
 274   guint    have_transform     : 1;
 275   guint    in_click           : 1;
 276   guint    wrap_mode          : 3;
 277   guint    pattern_set        : 1;
 278   guint    track_links        : 1;
 279
 280   guint    mnemonic_keyval;
 281
 282   gint     width_chars;
 283   gint     max_width_chars;
 284 };
 285
 286 /* Notes about the handling of links:
 287  *
 288  * Links share the GtkLabelSelectionInfo struct with selectable labels.
 289  * There are some new fields for links. The links field contains the list
 290  * of GtkLabelLink structs that describe the links which are embedded in
 291  * the label. The active_link field points to the link under the mouse
 292  * pointer. For keyboard navigation, the 'focus' link is determined by
 293  * finding the link which contains the selection_anchor position.
 294  * The link_clicked field is used with button press and release events
 295  * to ensure that pressing inside a link and releasing outside of it
 296  * does not activate the link.
 297  *
 298  * Links are rendered with the link-color/visited-link-color colors
 299  * that are determined by the style and with an underline. When the mouse
 300  * pointer is over a link, the pointer is changed to indicate the link,
 301  * and the background behind the link is rendered with the base[PRELIGHT]
 302  * color. While a button is pressed over a link, the background is rendered
 303  * with the base[ACTIVE] color.
 304  *
 305  * Labels with links accept keyboard focus, and it is possible to move
 306  * the focus between the embedded links using Tab/Shift-Tab. The focus
 307  * is indicated by a focus rectangle that is drawn around the link text.
 308  * Pressing Enter activates the focussed link, and there is a suitable
 309  * context menu for links that can be opened with the Menu key. Pressing
 310  * Control-C copies the link URI to the clipboard.
 311  *
 312  * In selectable labels with links, link functionality is only available
 313  * when the selection is empty.
 314  */
 315 typedef struct
 316 {
 317   gchar *uri;
 318   gchar *title;     /* the title attribute, used as tooltip */
 319   gboolean visited; /* get set when the link is activated; this flag
 320                      * gets preserved over later set_markup() calls
 321                      */
 322   gint start;       /* position of the link in the PangoLayout */
 323   gint end;
 324 } GtkLabelLink;
 325
 326 struct _GtkLabelSelectionInfo
 327 {
 328   GdkWindow *window;
 329   gint selection_anchor;
 330   gint selection_end;
 331   GtkWidget *popup_menu;
 332
 333   GList *links;
 334   GtkLabelLink *active_link;
 335
 336   gint drag_start_x;
 337   gint drag_start_y;
 338
 339   guint in_drag      : 1;
 340   guint select_words : 1;
 341   guint selectable   : 1;
 342   guint link_clicked : 1;
 343 };
 344
 345 enum {
 346   MOVE_CURSOR,
 347   COPY_CLIPBOARD,
 348   POPULATE_POPUP,
 349   ACTIVATE_LINK,
 350   ACTIVATE_CURRENT_LINK,
 351   LAST_SIGNAL
 352 };
 353
 354 enum {
 355   PROP_0,
 356   PROP_LABEL,
 357   PROP_ATTRIBUTES,
 358   PROP_USE_MARKUP,
 359   PROP_USE_UNDERLINE,
 360   PROP_JUSTIFY,
 361   PROP_PATTERN,
 362   PROP_WRAP,
 363   PROP_WRAP_MODE,
 364   PROP_SELECTABLE,
 365   PROP_MNEMONIC_KEYVAL,
 366   PROP_MNEMONIC_WIDGET,
 367   PROP_CURSOR_POSITION,
 368   PROP_SELECTION_BOUND,
 369   PROP_ELLIPSIZE,
 370   PROP_WIDTH_CHARS,
 371   PROP_SINGLE_LINE_MODE,
 372   PROP_ANGLE,
 373   PROP_MAX_WIDTH_CHARS,
 374   PROP_TRACK_VISITED_LINKS
 375 };
 376
 377 /* When rotating ellipsizable text we want the natural size to request
 378  * more to ensure the label wont ever ellipsize in an allocation of full natural size.
 379  * */
 380 #define ROTATION_ELLIPSIZE_PADDING 2
 381
 382 static guint signals[LAST_SIGNAL] = { 0 };
 383
 384 static const GdkColor default_link_color = { 0, 0, 0, 0xeeee };
 385 static const GdkColor default_visited_link_color = { 0, 0x5555, 0x1a1a, 0x8b8b };
 386
 387 static void gtk_label_set_property      (GObject          *object,
 388                                          guint             prop_id,
 389                                          const GValue     *value,
 390                                          GParamSpec       *pspec);
 391 static void gtk_label_get_property      (GObject          *object,
 392                                          guint             prop_id,
 393                                          GValue           *value,
 394                                          GParamSpec       *pspec);
 395 static void gtk_label_finalize          (GObject          *object);
 396 static void gtk_label_destroy           (GtkWidget        *widget);
 397 static void gtk_label_size_allocate     (GtkWidget        *widget,
 398                                          GtkAllocation    *allocation);
 399 static void gtk_label_state_changed     (GtkWidget        *widget,
 400                                          GtkStateType      state);
 401 static void gtk_label_style_updated     (GtkWidget        *widget);
 402 static void gtk_label_direction_changed (GtkWidget        *widget,
 403                                          GtkTextDirection  previous_dir);
 404 static gint gtk_label_draw              (GtkWidget        *widget,
 405                                          cairo_t          *cr);
 406 static gboolean gtk_label_focus         (GtkWidget         *widget,
 407                                          GtkDirectionType   direction);
 408
 409 static void gtk_label_realize           (GtkWidget        *widget);
 410 static void gtk_label_unrealize         (GtkWidget        *widget);
 411 static void gtk_label_map               (GtkWidget        *widget);
 412 static void gtk_label_unmap             (GtkWidget        *widget);
 413
 414 static gboolean gtk_label_button_press      (GtkWidget        *widget,
 415                                              GdkEventButton   *event);
 416 static gboolean gtk_label_button_release    (GtkWidget        *widget,
 417                                              GdkEventButton   *event);
 418 static gboolean gtk_label_motion            (GtkWidget        *widget,
 419                                              GdkEventMotion   *event);
 420 static gboolean gtk_label_leave_notify      (GtkWidget        *widget,
 421                                              GdkEventCrossing *event);
 422
 423 static void     gtk_label_grab_focus        (GtkWidget        *widget);
 424
 425 static gboolean gtk_label_query_tooltip     (GtkWidget        *widget,
 426                                              gint              x,
 427                                              gint              y,
 428                                              gboolean          keyboard_tip,
 429                                              GtkTooltip       *tooltip);
 430
 431 static void gtk_label_set_text_internal          (GtkLabel      *label,
 432                                                   gchar         *str);
 433 static void gtk_label_set_label_internal         (GtkLabel      *label,
 434                                                   gchar         *str);
 435 static void gtk_label_set_use_markup_internal    (GtkLabel      *label,
 436                                                   gboolean       val);
 437 static void gtk_label_set_use_underline_internal (GtkLabel      *label,
 438                                                   gboolean       val);
 439 static void gtk_label_set_attributes_internal    (GtkLabel      *label,
 440                                                   PangoAttrList *attrs);
 441 static void gtk_label_set_uline_text_internal    (GtkLabel      *label,
 442                                                   const gchar   *str);
 443 static void gtk_label_set_pattern_internal       (GtkLabel      *label,
 444                                                   const gchar   *pattern,
 445                                                   gboolean       is_mnemonic);
 446 static void gtk_label_set_markup_internal        (GtkLabel      *label,
 447                                                   const gchar   *str,
 448                                                   gboolean       with_uline);
 449 static void gtk_label_recalculate                (GtkLabel      *label);
 450 static void gtk_label_hierarchy_changed          (GtkWidget     *widget,
 451                                                   GtkWidget     *old_toplevel);
 452 static void gtk_label_screen_changed             (GtkWidget     *widget,
 453                                                   GdkScreen     *old_screen);
 454 static gboolean gtk_label_popup_menu             (GtkWidget     *widget);
 455
 456 static void gtk_label_create_window       (GtkLabel *label);
 457 static void gtk_label_destroy_window      (GtkLabel *label);
 458 static void gtk_label_ensure_select_info  (GtkLabel *label);
 459 static void gtk_label_clear_select_info   (GtkLabel *label);
 460 static void gtk_label_update_cursor       (GtkLabel *label);
 461 static void gtk_label_clear_layout        (GtkLabel *label);
 462 static void gtk_label_ensure_layout       (GtkLabel *label);
 463 static void gtk_label_select_region_index (GtkLabel *label,
 464                                            gint      anchor_index,
 465                                            gint      end_index);
 466
 467 static gboolean gtk_label_mnemonic_activate (GtkWidget         *widget,
 468                                              gboolean           group_cycling);
 469 static void     gtk_label_setup_mnemonic    (GtkLabel          *label,
 470                                              guint              last_key);
 471 static void     gtk_label_drag_data_get     (GtkWidget         *widget,
 472                                              GdkDragContext    *context,
 473                                              GtkSelectionData  *selection_data,
 474                                              guint              info,
 475                                              guint              time);
 476
 477 static void     gtk_label_buildable_interface_init     (GtkBuildableIface *iface);
 478 static gboolean gtk_label_buildable_custom_tag_start   (GtkBuildable     *buildable,
 479                                                         GtkBuilder       *builder,
 480                                                         GObject          *child,
 481                                                         const gchar      *tagname,
 482                                                         GMarkupParser    *parser,
 483                                                         gpointer         *data);
 484
 485 static void     gtk_label_buildable_custom_finished    (GtkBuildable     *buildable,
 486                                                         GtkBuilder       *builder,
 487                                                         GObject          *child,
 488                                                         const gchar      *tagname,
 489                                                         gpointer          user_data);
 490
 491
 492 static void connect_mnemonics_visible_notify    (GtkLabel   *label);
 493 static gboolean      separate_uline_pattern     (const gchar  *str,
 494                                                  guint        *accel_key,
 495                                                  gchar       **new_str,
 496                                                  gchar       **pattern);
 497
 498
 499 /* For selectable labels: */
 500 static void gtk_label_move_cursor        (GtkLabel        *label,
 501                                           GtkMovementStep  step,
 502                                           gint             count,
 503                                           gboolean         extend_selection);
 504 static void gtk_label_copy_clipboard     (GtkLabel        *label);
 505 static void gtk_label_select_all         (GtkLabel        *label);
 506 static void gtk_label_do_popup           (GtkLabel        *label,
 507                                           GdkEventButton  *event);
 508 static gint gtk_label_move_forward_word  (GtkLabel        *label,
 509                                           gint             start);
 510 static gint gtk_label_move_backward_word (GtkLabel        *label,
 511                                           gint             start);
 512
 513 /* For links: */
 514 static void          gtk_label_rescan_links     (GtkLabel  *label);
 515 static void          gtk_label_clear_links      (GtkLabel  *label);
 516 static gboolean      gtk_label_activate_link    (GtkLabel    *label,
 517                                                  const gchar *uri);
 518 static void          gtk_label_activate_current_link (GtkLabel *label);
 519 static GtkLabelLink *gtk_label_get_current_link (GtkLabel  *label);
 520 static void          gtk_label_get_link_colors  (GtkWidget  *widget,
 521                                                  GdkColor  **link_color,
 522                                                  GdkColor  **visited_link_color);
 523 static void          emit_activate_link         (GtkLabel     *label,
 524                                                  GtkLabelLink *link);
 525
 526 static GtkSizeRequestMode gtk_label_get_request_mode                (GtkWidget           *widget);
 527 static void               gtk_label_get_preferred_width             (GtkWidget           *widget,
 528                                                                      gint                *minimum_size,
 529                                                                      gint                *natural_size);
 530 static void               gtk_label_get_preferred_height            (GtkWidget           *widget,
 531                                                                      gint                *minimum_size,
 532                                                                      gint                *natural_size);
 533 static void               gtk_label_get_preferred_width_for_height  (GtkWidget           *widget,
 534                                                                      gint                 height,
 535                                                                      gint                *minimum_width,
 536                                                                      gint                *natural_width);
 537 static void               gtk_label_get_preferred_height_for_width  (GtkWidget           *widget,
 538                                                                      gint                 width,
 539                                                                      gint                *minimum_height,
 540                                                                      gint                *natural_height);
 541
 542 static GtkBuildableIface *buildable_parent_iface = NULL;
 543
 544 G_DEFINE_TYPE_WITH_CODE (GtkLabel, gtk_label, GTK_TYPE_MISC,
 545                          G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
 546                                                 gtk_label_buildable_interface_init))
 547
 548 static void
 549 add_move_binding (GtkBindingSet  *binding_set,
 550                   guint           keyval,
 551                   guint           modmask,
 552                   GtkMovementStep step,
 553                   gint            count)
 554 {
 555   g_return_if_fail ((modmask & GDK_SHIFT_MASK) == 0);
 556
 557   gtk_binding_entry_add_signal (binding_set, keyval, modmask,
 558                                 "move-cursor", 3,
 559                                 G_TYPE_ENUM, step,
 560                                 G_TYPE_INT, count,
 561                                 G_TYPE_BOOLEAN, FALSE);
 562
 563   /* Selection-extending version */
 564   gtk_binding_entry_add_signal (binding_set, keyval, modmask | GDK_SHIFT_MASK,
 565                                 "move-cursor", 3,
 566                                 G_TYPE_ENUM, step,
 567                                 G_TYPE_INT, count,
 568                                 G_TYPE_BOOLEAN, TRUE);
 569 }
 570
 571 static void
 572 gtk_label_class_init (GtkLabelClass *class)
 573 {
 574   GObjectClass *gobject_class = G_OBJECT_CLASS (class);
 575   GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
 576   GtkBindingSet *binding_set;
 577
 578   gobject_class->set_property = gtk_label_set_property;
 579   gobject_class->get_property = gtk_label_get_property;
 580   gobject_class->finalize = gtk_label_finalize;
 581
 582   widget_class->destroy = gtk_label_destroy;
 583   widget_class->size_allocate = gtk_label_size_allocate;
 584   widget_class->state_changed = gtk_label_state_changed;
 585   widget_class->style_updated = gtk_label_style_updated;
 586   widget_class->query_tooltip = gtk_label_query_tooltip;
 587   widget_class->direction_changed = gtk_label_direction_changed;
 588   widget_class->draw = gtk_label_draw;
 589   widget_class->realize = gtk_label_realize;
 590   widget_class->unrealize = gtk_label_unrealize;
 591   widget_class->map = gtk_label_map;
 592   widget_class->unmap = gtk_label_unmap;
 593   widget_class->button_press_event = gtk_label_button_press;
 594   widget_class->button_release_event = gtk_label_button_release;
 595   widget_class->motion_notify_event = gtk_label_motion;
 596   widget_class->leave_notify_event = gtk_label_leave_notify;
 597   widget_class->hierarchy_changed = gtk_label_hierarchy_changed;
 598   widget_class->screen_changed = gtk_label_screen_changed;
 599   widget_class->mnemonic_activate = gtk_label_mnemonic_activate;
 600   widget_class->drag_data_get = gtk_label_drag_data_get;
 601   widget_class->grab_focus = gtk_label_grab_focus;
 602   widget_class->popup_menu = gtk_label_popup_menu;
 603   widget_class->focus = gtk_label_focus;
 604   widget_class->get_request_mode = gtk_label_get_request_mode;
 605   widget_class->get_preferred_width = gtk_label_get_preferred_width;
 606   widget_class->get_preferred_height = gtk_label_get_preferred_height;
 607   widget_class->get_preferred_width_for_height = gtk_label_get_preferred_width_for_height;
 608   widget_class->get_preferred_height_for_width = gtk_label_get_preferred_height_for_width;
 609
 610   class->move_cursor = gtk_label_move_cursor;
 611   class->copy_clipboard = gtk_label_copy_clipboard;
 612   class->activate_link = gtk_label_activate_link;
 613
 614   /**
 615    * GtkLabel::move-cursor:
 616    * @entry: the object which received the signal
 617    * @step: the granularity of the move, as a #GtkMovementStep
 618    * @count: the number of @step units to move
 619    * @extend_selection: %TRUE if the move should extend the selection
 620    *
 621    * The ::move-cursor signal is a
 622    * <link linkend="keybinding-signals">keybinding signal</link>
 623    * which gets emitted when the user initiates a cursor movement.
 624    * If the cursor is not visible in @entry, this signal causes
 625    * the viewport to be moved instead.
 626    *
 627    * Applications should not connect to it, but may emit it with
 628    * g_signal_emit_by_name() if they need to control the cursor
 629    * programmatically.
 630    *
 631    * The default bindings for this signal come in two variants,
 632    * the variant with the Shift modifier extends the selection,
 633    * the variant without the Shift modifer does not.
 634    * There are too many key combinations to list them all here.
 635    * <itemizedlist>
 636    * <listitem>Arrow keys move by individual characters/lines</listitem>
 637    * <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem>
 638    * <listitem>Home/End keys move to the ends of the buffer</listitem>
 639    * </itemizedlist>
 640    */
 641   signals[MOVE_CURSOR] =
 642     g_signal_new (I_("move-cursor"),
 643                   G_OBJECT_CLASS_TYPE (gobject_class),
 644                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 645                   G_STRUCT_OFFSET (GtkLabelClass, move_cursor),
 646                   NULL, NULL,
 647                   _gtk_marshal_VOID__ENUM_INT_BOOLEAN,
 648                   G_TYPE_NONE, 3,
 649                   GTK_TYPE_MOVEMENT_STEP,
 650                   G_TYPE_INT,
 651                   G_TYPE_BOOLEAN);
 652
 653    /**
 654    * GtkLabel::copy-clipboard:
 655    * @label: the object which received the signal
 656    *
 657    * The ::copy-clipboard signal is a
 658    * <link linkend="keybinding-signals">keybinding signal</link>
 659    * which gets emitted to copy the selection to the clipboard.
 660    *
 661    * The default binding for this signal is Ctrl-c.
 662    */
 663   signals[COPY_CLIPBOARD] =
 664     g_signal_new (I_("copy-clipboard"),
 665                   G_OBJECT_CLASS_TYPE (gobject_class),
 666                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 667                   G_STRUCT_OFFSET (GtkLabelClass, copy_clipboard),
 668                   NULL, NULL,
 669                   _gtk_marshal_VOID__VOID,
 670                   G_TYPE_NONE, 0);
 671
 672   /**
 673    * GtkLabel::populate-popup:
 674    * @label: The label on which the signal is emitted
 675    * @menu: the menu that is being populated
 676    *
 677    * The ::populate-popup signal gets emitted before showing the
 678    * context menu of the label. Note that only selectable labels
 679    * have context menus.
 680    *
 681    * If you need to add items to the context menu, connect
 682    * to this signal and append your menuitems to the @menu.
 683    */
 684   signals[POPULATE_POPUP] =
 685     g_signal_new (I_("populate-popup"),
 686                   G_OBJECT_CLASS_TYPE (gobject_class),
 687                   G_SIGNAL_RUN_LAST,
 688                   G_STRUCT_OFFSET (GtkLabelClass, populate_popup),
 689                   NULL, NULL,
 690                   _gtk_marshal_VOID__OBJECT,
 691                   G_TYPE_NONE, 1,
 692                   GTK_TYPE_MENU);
 693
 694     /**
 695      * GtkLabel::activate-current-link:
 696      * @label: The label on which the signal was emitted
 697      *
 698      * A <link linkend="keybinding-signals">keybinding signal</link>
 699      * which gets emitted when the user activates a link in the label.
 700      *
 701      * Applications may also emit the signal with g_signal_emit_by_name()
 702      * if they need to control activation of URIs programmatically.
 703      *
 704      * The default bindings for this signal are all forms of the Enter key.
 705      *
 706      * Since: 2.18
 707      */
 708     signals[ACTIVATE_CURRENT_LINK] =
 709       g_signal_new_class_handler ("activate-current-link",
 710                                   G_TYPE_FROM_CLASS (gobject_class),
 711                                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 712                                   G_CALLBACK (gtk_label_activate_current_link),
 713                                   NULL, NULL,
 714                                   _gtk_marshal_VOID__VOID,
 715                                   G_TYPE_NONE, 0);
 716
 717     /**
 718      * GtkLabel::activate-link:
 719      * @label: The label on which the signal was emitted
 720      * @uri: the URI that is activated
 721      *
 722      * The signal which gets emitted to activate a URI.
 723      * Applications may connect to it to override the default behaviour,
 724      * which is to call gtk_show_uri().
 725      *
 726      * Returns: %TRUE if the link has been activated
 727      *
 728      * Since: 2.18
 729      */
 730     signals[ACTIVATE_LINK] =
 731       g_signal_new ("activate-link",
 732                     G_TYPE_FROM_CLASS (gobject_class),
 733                     G_SIGNAL_RUN_LAST,
 734                     G_STRUCT_OFFSET (GtkLabelClass, activate_link),
 735                     _gtk_boolean_handled_accumulator, NULL,
 736                     _gtk_marshal_BOOLEAN__STRING,
 737                     G_TYPE_BOOLEAN, 1, G_TYPE_STRING);
 738
 739   g_object_class_install_property (gobject_class,
 740                                    PROP_LABEL,
 741                                    g_param_spec_string ("label",
 742                                                         P_("Label"),
 743                                                         P_("The text of the label"),
 744                                                         "",
 745                                                         GTK_PARAM_READWRITE));
 746   g_object_class_install_property (gobject_class,
 747                                    PROP_ATTRIBUTES,
 748                                    g_param_spec_boxed ("attributes",
 749                                                        P_("Attributes"),
 750                                                        P_("A list of style attributes to apply to the text of the label"),
 751                                                        PANGO_TYPE_ATTR_LIST,
 752                                                        GTK_PARAM_READWRITE));
 753   g_object_class_install_property (gobject_class,
 754                                    PROP_USE_MARKUP,
 755                                    g_param_spec_boolean ("use-markup",
 756                                                          P_("Use markup"),
 757                                                          P_("The text of the label includes XML markup. See pango_parse_markup()"),
 758                                                         FALSE,
 759                                                         GTK_PARAM_READWRITE));
 760   g_object_class_install_property (gobject_class,
 761                                    PROP_USE_UNDERLINE,
 762                                    g_param_spec_boolean ("use-underline",
 763                                                          P_("Use underline"),
 764                                                          P_("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
 765                                                         FALSE,
 766                                                         GTK_PARAM_READWRITE));
 767
 768   g_object_class_install_property (gobject_class,
 769                                    PROP_JUSTIFY,
 770                                    g_param_spec_enum ("justify",
 771                                                       P_("Justification"),
 772                                                       P_("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"),
 773                                                       GTK_TYPE_JUSTIFICATION,
 774                                                       GTK_JUSTIFY_LEFT,
 775                                                       GTK_PARAM_READWRITE));
 776
 777   g_object_class_install_property (gobject_class,
 778                                    PROP_PATTERN,
 779                                    g_param_spec_string ("pattern",
 780                                                         P_("Pattern"),
 781                                                         P_("A string with _ characters in positions correspond to characters in the text to underline"),
 782                                                         NULL,
 783                                                         GTK_PARAM_WRITABLE));
 784
 785   g_object_class_install_property (gobject_class,
 786                                    PROP_WRAP,
 787                                    g_param_spec_boolean ("wrap",
 788                                                         P_("Line wrap"),
 789                                                         P_("If set, wrap lines if the text becomes too wide"),
 790                                                         FALSE,
 791                                                         GTK_PARAM_READWRITE));
 792   /**
 793    * GtkLabel:wrap-mode:
 794    *
 795    * If line wrapping is on (see the #GtkLabel:wrap property) this controls
 796    * how the line wrapping is done. The default is %PANGO_WRAP_WORD, which
 797    * means wrap on word boundaries.
 798    *
 799    * Since: 2.10
 800    */
 801   g_object_class_install_property (gobject_class,
 802                                    PROP_WRAP_MODE,
 803                                    g_param_spec_enum ("wrap-mode",
 804                                                       P_("Line wrap mode"),
 805                                                       P_("If wrap is set, controls how linewrapping is done"),
 806                                                       PANGO_TYPE_WRAP_MODE,
 807                                                       PANGO_WRAP_WORD,
 808                                                       GTK_PARAM_READWRITE));
 809   g_object_class_install_property (gobject_class,
 810                                    PROP_SELECTABLE,
 811                                    g_param_spec_boolean ("selectable",
 812                                                         P_("Selectable"),
 813                                                         P_("Whether the label text can be selected with the mouse"),
 814                                                         FALSE,
 815                                                         GTK_PARAM_READWRITE));
 816   g_object_class_install_property (gobject_class,
 817                                    PROP_MNEMONIC_KEYVAL,
 818                                    g_param_spec_uint ("mnemonic-keyval",
 819                                                       P_("Mnemonic key"),
 820                                                       P_("The mnemonic accelerator key for this label"),
 821                                                       0,
 822                                                       G_MAXUINT,
 823                                                       GDK_KEY_VoidSymbol,
 824                                                       GTK_PARAM_READABLE));
 825   g_object_class_install_property (gobject_class,
 826                                    PROP_MNEMONIC_WIDGET,
 827                                    g_param_spec_object ("mnemonic-widget",
 828                                                         P_("Mnemonic widget"),
 829                                                         P_("The widget to be activated when the label's mnemonic "
 830                                                           "key is pressed"),
 831                                                         GTK_TYPE_WIDGET,
 832                                                         GTK_PARAM_READWRITE));
 833
 834   g_object_class_install_property (gobject_class,
 835                                    PROP_CURSOR_POSITION,
 836                                    g_param_spec_int ("cursor-position",
 837                                                      P_("Cursor Position"),
 838                                                      P_("The current position of the insertion cursor in chars"),
 839                                                      0,
 840                                                      G_MAXINT,
 841                                                      0,
 842                                                      GTK_PARAM_READABLE));
 843
 844   g_object_class_install_property (gobject_class,
 845                                    PROP_SELECTION_BOUND,
 846                                    g_param_spec_int ("selection-bound",
 847                                                      P_("Selection Bound"),
 848                                                      P_("The position of the opposite end of the selection from the cursor in chars"),
 849                                                      0,
 850                                                      G_MAXINT,
 851                                                      0,
 852                                                      GTK_PARAM_READABLE));
 853
 854   /**
 855    * GtkLabel:ellipsize:
 856    *
 857    * The preferred place to ellipsize the string, if the label does
 858    * not have enough room to display the entire string, specified as a
 859    * #PangoEllisizeMode.
 860    *
 861    * Note that setting this property to a value other than
 862    * %PANGO_ELLIPSIZE_NONE has the side-effect that the label requests
 863    * only enough space to display the ellipsis "...". In particular, this
 864    * means that ellipsizing labels do not work well in notebook tabs, unless
 865    * the tab's #GtkNotebook:tab-expand property is set to %TRUE. Other ways
 866    * to set a label's width are gtk_widget_set_size_request() and
 867    * gtk_label_set_width_chars().
 868    *
 869    * Since: 2.6
 870    */
 871   g_object_class_install_property (gobject_class,
 872                                    PROP_ELLIPSIZE,
 873                                    g_param_spec_enum ("ellipsize",
 874                                                       P_("Ellipsize"),
 875                                                       P_("The preferred place to ellipsize the string, if the label does not have enough room to display the entire string"),
 876                                                       PANGO_TYPE_ELLIPSIZE_MODE,
 877                                                       PANGO_ELLIPSIZE_NONE,
 878                                                       GTK_PARAM_READWRITE));
 879
 880   /**
 881    * GtkLabel:width-chars:
 882    *
 883    * The desired width of the label, in characters. If this property is set to
 884    * -1, the width will be calculated automatically.
 885    *
 886    * See the section on <link linkend="label-text-layout">text layout</link>
 887    * for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars
 888    * determine the width of ellipsized and wrapped labels.
 889    *
 890    * Since: 2.6
 891    **/
 892   g_object_class_install_property (gobject_class,
 893                                    PROP_WIDTH_CHARS,
 894                                    g_param_spec_int ("width-chars",
 895                                                      P_("Width In Characters"),
 896                                                      P_("The desired width of the label, in characters"),
 897                                                      -1,
 898                                                      G_MAXINT,
 899                                                      -1,
 900                                                      GTK_PARAM_READWRITE));
 901
 902   /**
 903    * GtkLabel:single-line-mode:
 904    *
 905    * Whether the label is in single line mode. In single line mode,
 906    * the height of the label does not depend on the actual text, it
 907    * is always set to ascent + descent of the font. This can be an
 908    * advantage in situations where resizing the label because of text
 909    * changes would be distracting, e.g. in a statusbar.
 910    *
 911    * Since: 2.6
 912    **/
 913   g_object_class_install_property (gobject_class,
 914                                    PROP_SINGLE_LINE_MODE,
 915                                    g_param_spec_boolean ("single-line-mode",
 916                                                         P_("Single Line Mode"),
 917                                                         P_("Whether the label is in single line mode"),
 918                                                         FALSE,
 919                                                         GTK_PARAM_READWRITE));
 920
 921   /**
 922    * GtkLabel:angle:
 923    *
 924    * The angle that the baseline of the label makes with the horizontal,
 925    * in degrees, measured counterclockwise. An angle of 90 reads from
 926    * from bottom to top, an angle of 270, from top to bottom. Ignored
 927    * if the label is selectable, wrapped, or ellipsized.
 928    *
 929    * Since: 2.6
 930    **/
 931   g_object_class_install_property (gobject_class,
 932                                    PROP_ANGLE,
 933                                    g_param_spec_double ("angle",
 934                                                         P_("Angle"),
 935                                                         P_("Angle at which the label is rotated"),
 936                                                         0.0,
 937                                                         360.0,
 938                                                         0.0,
 939                                                         GTK_PARAM_READWRITE));
 940
 941   /**
 942    * GtkLabel:max-width-chars:
 943    *
 944    * The desired maximum width of the label, in characters. If this property
 945    * is set to -1, the width will be calculated automatically.
 946    *
 947    * See the section on <link linkend="label-text-layout">text layout</link>
 948    * for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars
 949    * determine the width of ellipsized and wrapped labels.
 950    *
 951    * Since: 2.6
 952    **/
 953   g_object_class_install_property (gobject_class,
 954                                    PROP_MAX_WIDTH_CHARS,
 955                                    g_param_spec_int ("max-width-chars",
 956                                                      P_("Maximum Width In Characters"),
 957                                                      P_("The desired maximum width of the label, in characters"),
 958                                                      -1,
 959                                                      G_MAXINT,
 960                                                      -1,
 961                                                      GTK_PARAM_READWRITE));
 962
 963   /**
 964    * GtkLabel:track-visited-links:
 965    *
 966    * Set this property to %TRUE to make the label track which links
 967    * have been clicked. It will then apply the ::visited-link-color
 968    * color, instead of ::link-color.
 969    *
 970    * Since: 2.18
 971    */
 972   g_object_class_install_property (gobject_class,
 973                                    PROP_TRACK_VISITED_LINKS,
 974                                    g_param_spec_boolean ("track-visited-links",
 975                                                          P_("Track visited links"),
 976                                                          P_("Whether visited links should be tracked"),
 977                                                          TRUE,
 978                                                          GTK_PARAM_READWRITE));
 979   /*
 980    * Key bindings
 981    */
 982
 983   binding_set = gtk_binding_set_by_class (class);
 984
 985   /* Moving the insertion point */
 986   add_move_binding (binding_set, GDK_KEY_Right, 0,
 987                     GTK_MOVEMENT_VISUAL_POSITIONS, 1);
 988
 989   add_move_binding (binding_set, GDK_KEY_Left, 0,
 990                     GTK_MOVEMENT_VISUAL_POSITIONS, -1);
 991
 992   add_move_binding (binding_set, GDK_KEY_KP_Right, 0,
 993                     GTK_MOVEMENT_VISUAL_POSITIONS, 1);
 994
 995   add_move_binding (binding_set, GDK_KEY_KP_Left, 0,
 996                     GTK_MOVEMENT_VISUAL_POSITIONS, -1);
 997
 998   add_move_binding (binding_set, GDK_KEY_f, GDK_CONTROL_MASK,
 999                     GTK_MOVEMENT_LOGICAL_POSITIONS, 1);
1000
1001   add_move_binding (binding_set, GDK_KEY_b, GDK_CONTROL_MASK,
1002                     GTK_MOVEMENT_LOGICAL_POSITIONS, -1);
1003
1004   add_move_binding (binding_set, GDK_KEY_Right, GDK_CONTROL_MASK,
1005                     GTK_MOVEMENT_WORDS, 1);
1006
1007   add_move_binding (binding_set, GDK_KEY_Left, GDK_CONTROL_MASK,
1008                     GTK_MOVEMENT_WORDS, -1);
1009
1010   add_move_binding (binding_set, GDK_KEY_KP_Right, GDK_CONTROL_MASK,
1011                     GTK_MOVEMENT_WORDS, 1);
1012
1013   add_move_binding (binding_set, GDK_KEY_KP_Left, GDK_CONTROL_MASK,
1014                     GTK_MOVEMENT_WORDS, -1);
1015
1016   /* select all */
1017   gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_CONTROL_MASK,
1018                                 "move-cursor", 3,
1019                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1020                                 G_TYPE_INT, -1,
1021                                 G_TYPE_BOOLEAN, FALSE);
1022
1023   gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_CONTROL_MASK,
1024                                 "move-cursor", 3,
1025                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1026                                 G_TYPE_INT, 1,
1027                                 G_TYPE_BOOLEAN, TRUE);
1028
1029   gtk_binding_entry_add_signal (binding_set, GDK_KEY_slash, GDK_CONTROL_MASK,
1030                                 "move-cursor", 3,
1031                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1032                                 G_TYPE_INT, -1,
1033                                 G_TYPE_BOOLEAN, FALSE);
1034
1035   gtk_binding_entry_add_signal (binding_set, GDK_KEY_slash, GDK_CONTROL_MASK,
1036                                 "move-cursor", 3,
1037                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1038                                 G_TYPE_INT, 1,
1039                                 G_TYPE_BOOLEAN, TRUE);
1040
1041   /* unselect all */
1042   gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_SHIFT_MASK | GDK_CONTROL_MASK,
1043                                 "move-cursor", 3,
1044                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1045                                 G_TYPE_INT, 0,
1046                                 G_TYPE_BOOLEAN, FALSE);
1047
1048   gtk_binding_entry_add_signal (binding_set, GDK_KEY_backslash, GDK_CONTROL_MASK,
1049                                 "move-cursor", 3,
1050                                 G_TYPE_ENUM, GTK_MOVEMENT_PARAGRAPH_ENDS,
1051                                 G_TYPE_INT, 0,
1052                                 G_TYPE_BOOLEAN, FALSE);
1053
1054   add_move_binding (binding_set, GDK_KEY_f, GDK_MOD1_MASK,
1055                     GTK_MOVEMENT_WORDS, 1);
1056
1057   add_move_binding (binding_set, GDK_KEY_b, GDK_MOD1_MASK,
1058                     GTK_MOVEMENT_WORDS, -1);
1059
1060   add_move_binding (binding_set, GDK_KEY_Home, 0,
1061                     GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1);
1062
1063   add_move_binding (binding_set, GDK_KEY_End, 0,
1064                     GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1);
1065
1066   add_move_binding (binding_set, GDK_KEY_KP_Home, 0,
1067                     GTK_MOVEMENT_DISPLAY_LINE_ENDS, -1);
1068
1069   add_move_binding (binding_set, GDK_KEY_KP_End, 0,
1070                     GTK_MOVEMENT_DISPLAY_LINE_ENDS, 1);
1071
1072   add_move_binding (binding_set, GDK_KEY_Home, GDK_CONTROL_MASK,
1073                     GTK_MOVEMENT_BUFFER_ENDS, -1);
1074
1075   add_move_binding (binding_set, GDK_KEY_End, GDK_CONTROL_MASK,
1076                     GTK_MOVEMENT_BUFFER_ENDS, 1);
1077
1078   add_move_binding (binding_set, GDK_KEY_KP_Home, GDK_CONTROL_MASK,
1079                     GTK_MOVEMENT_BUFFER_ENDS, -1);
1080
1081   add_move_binding (binding_set, GDK_KEY_KP_End, GDK_CONTROL_MASK,
1082                     GTK_MOVEMENT_BUFFER_ENDS, 1);
1083
1084   /* copy */
1085   gtk_binding_entry_add_signal (binding_set, GDK_KEY_c, GDK_CONTROL_MASK,
1086                                 "copy-clipboard", 0);
1087
1088   gtk_binding_entry_add_signal (binding_set, GDK_KEY_Return, 0,
1089                                 "activate-current-link", 0);
1090   gtk_binding_entry_add_signal (binding_set, GDK_KEY_ISO_Enter, 0,
1091                                 "activate-current-link", 0);
1092   gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Enter, 0,
1093                                 "activate-current-link", 0);
1094
1095   g_type_class_add_private (class, sizeof (GtkLabelPrivate));
1096 }
1097
1098 static void
1099 gtk_label_set_property (GObject      *object,
1100                         guint         prop_id,
1101                         const GValue *value,
1102                         GParamSpec   *pspec)
1103 {
1104   GtkLabel *label = GTK_LABEL (object);
1105
1106   switch (prop_id)
1107     {
1108     case PROP_LABEL:
1109       gtk_label_set_label (label, g_value_get_string (value));
1110       break;
1111     case PROP_ATTRIBUTES:
1112       gtk_label_set_attributes (label, g_value_get_boxed (value));
1113       break;
1114     case PROP_USE_MARKUP:
1115       gtk_label_set_use_markup (label, g_value_get_boolean (value));
1116       break;
1117     case PROP_USE_UNDERLINE:
1118       gtk_label_set_use_underline (label, g_value_get_boolean (value));
1119       break;
1120     case PROP_JUSTIFY:
1121       gtk_label_set_justify (label, g_value_get_enum (value));
1122       break;
1123     case PROP_PATTERN:
1124       gtk_label_set_pattern (label, g_value_get_string (value));
1125       break;
1126     case PROP_WRAP:
1127       gtk_label_set_line_wrap (label, g_value_get_boolean (value));
1128       break;
1129     case PROP_WRAP_MODE:
1130       gtk_label_set_line_wrap_mode (label, g_value_get_enum (value));
1131       break;
1132     case PROP_SELECTABLE:
1133       gtk_label_set_selectable (label, g_value_get_boolean (value));
1134       break;
1135     case PROP_MNEMONIC_WIDGET:
1136       gtk_label_set_mnemonic_widget (label, (GtkWidget*) g_value_get_object (value));
1137       break;
1138     case PROP_ELLIPSIZE:
1139       gtk_label_set_ellipsize (label, g_value_get_enum (value));
1140       break;
1141     case PROP_WIDTH_CHARS:
1142       gtk_label_set_width_chars (label, g_value_get_int (value));
1143       break;
1144     case PROP_SINGLE_LINE_MODE:
1145       gtk_label_set_single_line_mode (label, g_value_get_boolean (value));
1146       break;
1147     case PROP_ANGLE:
1148       gtk_label_set_angle (label, g_value_get_double (value));
1149       break;
1150     case PROP_MAX_WIDTH_CHARS:
1151       gtk_label_set_max_width_chars (label, g_value_get_int (value));
1152       break;
1153     case PROP_TRACK_VISITED_LINKS:
1154       gtk_label_set_track_visited_links (label, g_value_get_boolean (value));
1155       break;
1156     default:
1157       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1158       break;
1159     }
1160 }
1161
1162 static void
1163 gtk_label_get_property (GObject     *object,
1164                         guint        prop_id,
1165                         GValue      *value,
1166                         GParamSpec  *pspec)
1167 {
1168   GtkLabel *label = GTK_LABEL (object);
1169   GtkLabelPrivate *priv = label->priv;
1170
1171   switch (prop_id)
1172     {
1173     case PROP_LABEL:
1174       g_value_set_string (value, priv->label);
1175       break;
1176     case PROP_ATTRIBUTES:
1177       g_value_set_boxed (value, priv->attrs);
1178       break;
1179     case PROP_USE_MARKUP:
1180       g_value_set_boolean (value, priv->use_markup);
1181       break;
1182     case PROP_USE_UNDERLINE:
1183       g_value_set_boolean (value, priv->use_underline);
1184       break;
1185     case PROP_JUSTIFY:
1186       g_value_set_enum (value, priv->jtype);
1187       break;
1188     case PROP_WRAP:
1189       g_value_set_boolean (value, priv->wrap);
1190       break;
1191     case PROP_WRAP_MODE:
1192       g_value_set_enum (value, priv->wrap_mode);
1193       break;
1194     case PROP_SELECTABLE:
1195       g_value_set_boolean (value, gtk_label_get_selectable (label));
1196       break;
1197     case PROP_MNEMONIC_KEYVAL:
1198       g_value_set_uint (value, priv->mnemonic_keyval);
1199       break;
1200     case PROP_MNEMONIC_WIDGET:
1201       g_value_set_object (value, (GObject*) priv->mnemonic_widget);
1202       break;
1203     case PROP_CURSOR_POSITION:
1204       if (priv->select_info && priv->select_info->selectable)
1205         {
1206           gint offset = g_utf8_pointer_to_offset (priv->text,
1207                                                   priv->text + priv->select_info->selection_end);
1208           g_value_set_int (value, offset);
1209         }
1210       else
1211         g_value_set_int (value, 0);
1212       break;
1213     case PROP_SELECTION_BOUND:
1214       if (priv->select_info && priv->select_info->selectable)
1215         {
1216           gint offset = g_utf8_pointer_to_offset (priv->text,
1217                                                   priv->text + priv->select_info->selection_anchor);
1218           g_value_set_int (value, offset);
1219         }
1220       else
1221         g_value_set_int (value, 0);
1222       break;
1223     case PROP_ELLIPSIZE:
1224       g_value_set_enum (value, priv->ellipsize);
1225       break;
1226     case PROP_WIDTH_CHARS:
1227       g_value_set_int (value, gtk_label_get_width_chars (label));
1228       break;
1229     case PROP_SINGLE_LINE_MODE:
1230       g_value_set_boolean (value, gtk_label_get_single_line_mode (label));
1231       break;
1232     case PROP_ANGLE:
1233       g_value_set_double (value, gtk_label_get_angle (label));
1234       break;
1235     case PROP_MAX_WIDTH_CHARS:
1236       g_value_set_int (value, gtk_label_get_max_width_chars (label));
1237       break;
1238     case PROP_TRACK_VISITED_LINKS:
1239       g_value_set_boolean (value, gtk_label_get_track_visited_links (label));
1240       break;
1241     default:
1242       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1243       break;
1244     }
1245 }
1246
1247 static void
1248 gtk_label_init (GtkLabel *label)
1249 {
1250   GtkLabelPrivate *priv;
1251
1252   label->priv = G_TYPE_INSTANCE_GET_PRIVATE (label,
1253                                              GTK_TYPE_LABEL,
1254                                              GtkLabelPrivate);
1255   priv = label->priv;
1256
1257   gtk_widget_set_has_window (GTK_WIDGET (label), FALSE);
1258
1259   priv->width_chars = -1;
1260   priv->max_width_chars = -1;
1261   priv->label = NULL;
1262
1263   priv->jtype = GTK_JUSTIFY_LEFT;
1264   priv->wrap = FALSE;
1265   priv->wrap_mode = PANGO_WRAP_WORD;
1266   priv->ellipsize = PANGO_ELLIPSIZE_NONE;
1267
1268   priv->use_underline = FALSE;
1269   priv->use_markup = FALSE;
1270   priv->pattern_set = FALSE;
1271   priv->track_links = TRUE;
1272
1273   priv->mnemonic_keyval = GDK_KEY_VoidSymbol;
1274   priv->layout = NULL;
1275   priv->text = NULL;
1276   priv->attrs = NULL;
1277
1278   priv->mnemonic_widget = NULL;
1279   priv->mnemonic_window = NULL;
1280
1281   priv->mnemonics_visible = TRUE;
1282
1283   gtk_label_set_text (label, "");
1284 }
1285
1286
1287 static void
1288 gtk_label_buildable_interface_init (GtkBuildableIface *iface)
1289 {
1290   buildable_parent_iface = g_type_interface_peek_parent (iface);
1291
1292   iface->custom_tag_start = gtk_label_buildable_custom_tag_start;
1293   iface->custom_finished = gtk_label_buildable_custom_finished;
1294 }
1295
1296 typedef struct {
1297   GtkBuilder    *builder;
1298   GObject       *object;
1299   PangoAttrList *attrs;
1300 } PangoParserData;
1301
1302 static PangoAttribute *
1303 attribute_from_text (GtkBuilder   *builder,
1304                      const gchar  *name,
1305                      const gchar  *value,
1306                      GError      **error)
1307 {
1308   PangoAttribute *attribute = NULL;
1309   PangoAttrType   type;
1310   PangoLanguage  *language;
1311   PangoFontDescription *font_desc;
1312   GdkColor       *color;
1313   GValue          val = { 0, };
1314
1315   if (!gtk_builder_value_from_string_type (builder, PANGO_TYPE_ATTR_TYPE, name, &val, error))
1316     return NULL;
1317
1318   type = g_value_get_enum (&val);
1319   g_value_unset (&val);
1320
1321   switch (type)
1322     {
1323       /* PangoAttrLanguage */
1324     case PANGO_ATTR_LANGUAGE:
1325       if ((language = pango_language_from_string (value)))
1326         {
1327           attribute = pango_attr_language_new (language);
1328           g_value_init (&val, G_TYPE_INT);
1329         }
1330       break;
1331       /* PangoAttrInt */
1332     case PANGO_ATTR_STYLE:
1333       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_STYLE, value, &val, error))
1334         attribute = pango_attr_style_new (g_value_get_enum (&val));
1335       break;
1336     case PANGO_ATTR_WEIGHT:
1337       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_WEIGHT, value, &val, error))
1338         attribute = pango_attr_weight_new (g_value_get_enum (&val));
1339       break;
1340     case PANGO_ATTR_VARIANT:
1341       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_VARIANT, value, &val, error))
1342         attribute = pango_attr_variant_new (g_value_get_enum (&val));
1343       break;
1344     case PANGO_ATTR_STRETCH:
1345       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_STRETCH, value, &val, error))
1346         attribute = pango_attr_stretch_new (g_value_get_enum (&val));
1347       break;
1348     case PANGO_ATTR_UNDERLINE:
1349       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_UNDERLINE, value, &val, NULL))
1350         attribute = pango_attr_underline_new (g_value_get_enum (&val));
1351       else
1352         {
1353           /* XXX: allow boolean for backwards compat, so ignore error */
1354           /* Deprecate this somehow */
1355           g_value_unset (&val);
1356           if (gtk_builder_value_from_string_type (builder, G_TYPE_BOOLEAN, value, &val, error))
1357             attribute = pango_attr_underline_new (g_value_get_boolean (&val));
1358         }
1359       break;
1360     case PANGO_ATTR_STRIKETHROUGH:
1361       if (gtk_builder_value_from_string_type (builder, G_TYPE_BOOLEAN, value, &val, error))
1362         attribute = pango_attr_strikethrough_new (g_value_get_boolean (&val));
1363       break;
1364     case PANGO_ATTR_GRAVITY:
1365       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_GRAVITY, value, &val, error))
1366         attribute = pango_attr_gravity_new (g_value_get_enum (&val));
1367       break;
1368     case PANGO_ATTR_GRAVITY_HINT:
1369       if (gtk_builder_value_from_string_type (builder, PANGO_TYPE_GRAVITY_HINT,
1370                                               value, &val, error))
1371         attribute = pango_attr_gravity_hint_new (g_value_get_enum (&val));
1372       break;
1373       /* PangoAttrString */
1374     case PANGO_ATTR_FAMILY:
1375       attribute = pango_attr_family_new (value);
1376       g_value_init (&val, G_TYPE_INT);
1377       break;
1378
1379       /* PangoAttrSize */
1380     case PANGO_ATTR_SIZE:
1381       if (gtk_builder_value_from_string_type (builder, G_TYPE_INT,
1382                                               value, &val, error))
1383         attribute = pango_attr_size_new (g_value_get_int (&val));
1384       break;
1385     case PANGO_ATTR_ABSOLUTE_SIZE:
1386       if (gtk_builder_value_from_string_type (builder, G_TYPE_INT,
1387                                               value, &val, error))
1388         attribute = pango_attr_size_new_absolute (g_value_get_int (&val));
1389       break;
1390
1391       /* PangoAttrFontDesc */
1392     case PANGO_ATTR_FONT_DESC:
1393       if ((font_desc = pango_font_description_from_string (value)))
1394         {
1395           attribute = pango_attr_font_desc_new (font_desc);
1396           pango_font_description_free (font_desc);
1397           g_value_init (&val, G_TYPE_INT);
1398         }
1399       break;
1400
1401       /* PangoAttrColor */
1402     case PANGO_ATTR_FOREGROUND:
1403       if (gtk_builder_value_from_string_type (builder, GDK_TYPE_COLOR,
1404                                               value, &val, error))
1405         {
1406           color = g_value_get_boxed (&val);
1407           attribute = pango_attr_foreground_new (color->red, color->green, color->blue);
1408         }
1409       break;
1410     case PANGO_ATTR_BACKGROUND:
1411       if (gtk_builder_value_from_string_type (builder, GDK_TYPE_COLOR,
1412                                               value, &val, error))
1413         {
1414           color = g_value_get_boxed (&val);
1415           attribute = pango_attr_background_new (color->red, color->green, color->blue);
1416         }
1417       break;
1418     case PANGO_ATTR_UNDERLINE_COLOR:
1419       if (gtk_builder_value_from_string_type (builder, GDK_TYPE_COLOR,
1420                                               value, &val, error))
1421         {
1422           color = g_value_get_boxed (&val);
1423           attribute = pango_attr_underline_color_new (color->red, color->green, color->blue);
1424         }
1425       break;
1426     case PANGO_ATTR_STRIKETHROUGH_COLOR:
1427       if (gtk_builder_value_from_string_type (builder, GDK_TYPE_COLOR,
1428                                               value, &val, error))
1429         {
1430           color = g_value_get_boxed (&val);
1431           attribute = pango_attr_strikethrough_color_new (color->red, color->green, color->blue);
1432         }
1433       break;
1434
1435       /* PangoAttrShape */
1436     case PANGO_ATTR_SHAPE:
1437       /* Unsupported for now */
1438       break;
1439       /* PangoAttrFloat */
1440     case PANGO_ATTR_SCALE:
1441       if (gtk_builder_value_from_string_type (builder, G_TYPE_DOUBLE,
1442                                               value, &val, error))
1443         attribute = pango_attr_scale_new (g_value_get_double (&val));
1444       break;
1445
1446     case PANGO_ATTR_INVALID:
1447     case PANGO_ATTR_LETTER_SPACING:
1448     case PANGO_ATTR_RISE:
1449     case PANGO_ATTR_FALLBACK:
1450     default:
1451       break;
1452     }
1453
1454   g_value_unset (&val);
1455
1456   return attribute;
1457 }
1458
1459
1460 static void
1461 pango_start_element (GMarkupParseContext *context,
1462                      const gchar         *element_name,
1463                      const gchar        **names,
1464                      const gchar        **values,
1465                      gpointer             user_data,
1466                      GError             **error)
1467 {
1468   PangoParserData *data = (PangoParserData*)user_data;
1469   GValue val = { 0, };
1470   guint i;
1471   gint line_number, char_number;
1472
1473   if (strcmp (element_name, "attribute") == 0)
1474     {
1475       PangoAttribute *attr = NULL;
1476       const gchar *name = NULL;
1477       const gchar *value = NULL;
1478       const gchar *start = NULL;
1479       const gchar *end = NULL;
1480       guint start_val = 0;
1481       guint end_val   = G_MAXUINT;
1482
1483       for (i = 0; names[i]; i++)
1484         {
1485           if (strcmp (names[i], "name") == 0)
1486             name = values[i];
1487           else if (strcmp (names[i], "value") == 0)
1488             value = values[i];
1489           else if (strcmp (names[i], "start") == 0)
1490             start = values[i];
1491           else if (strcmp (names[i], "end") == 0)
1492             end = values[i];
1493           else
1494             {
1495               g_markup_parse_context_get_position (context,
1496                                                    &line_number,
1497                                                    &char_number);
1498               g_set_error (error,
1499                            GTK_BUILDER_ERROR,
1500                            GTK_BUILDER_ERROR_INVALID_ATTRIBUTE,
1501                            "%s:%d:%d '%s' is not a valid attribute of <%s>",
1502                            "<input>",
1503                            line_number, char_number, names[i], "attribute");
1504               return;
1505             }
1506         }
1507
1508       if (!name || !value)
1509         {
1510           g_markup_parse_context_get_position (context,
1511                                                &line_number,
1512                                                &char_number);
1513           g_set_error (error,
1514                        GTK_BUILDER_ERROR,
1515                        GTK_BUILDER_ERROR_MISSING_ATTRIBUTE,
1516                        "%s:%d:%d <%s> requires attribute \"%s\"",
1517                        "<input>",
1518                        line_number, char_number, "attribute",
1519                        name ? "value" : "name");
1520           return;
1521         }
1522
1523       if (start)
1524         {
1525           if (!gtk_builder_value_from_string_type (data->builder, G_TYPE_UINT,
1526                                                    start, &val, error))
1527             return;
1528           start_val = g_value_get_uint (&val);
1529           g_value_unset (&val);
1530         }
1531
1532       if (end)
1533         {
1534           if (!gtk_builder_value_from_string_type (data->builder, G_TYPE_UINT,
1535                                                    end, &val, error))
1536             return;
1537           end_val = g_value_get_uint (&val);
1538           g_value_unset (&val);
1539         }
1540
1541       attr = attribute_from_text (data->builder, name, value, error);
1542
1543       if (attr)
1544         {
1545           attr->start_index = start_val;
1546           attr->end_index   = end_val;
1547
1548           if (!data->attrs)
1549             data->attrs = pango_attr_list_new ();
1550
1551           pango_attr_list_insert (data->attrs, attr);
1552         }
1553     }
1554   else if (strcmp (element_name, "attributes") == 0)
1555     ;
1556   else
1557     g_warning ("Unsupported tag for GtkLabel: %s\n", element_name);
1558 }
1559
1560 static const GMarkupParser pango_parser =
1561   {
1562     pango_start_element,
1563   };
1564
1565 static gboolean
1566 gtk_label_buildable_custom_tag_start (GtkBuildable     *buildable,
1567                                       GtkBuilder       *builder,
1568                                       GObject          *child,
1569                                       const gchar      *tagname,
1570                                       GMarkupParser    *parser,
1571                                       gpointer         *data)
1572 {
1573   if (buildable_parent_iface->custom_tag_start (buildable, builder, child,
1574                                                 tagname, parser, data))
1575     return TRUE;
1576
1577   if (strcmp (tagname, "attributes") == 0)
1578     {
1579       PangoParserData *parser_data;
1580
1581       parser_data = g_slice_new0 (PangoParserData);
1582       parser_data->builder = g_object_ref (builder);
1583       parser_data->object = g_object_ref (buildable);
1584       *parser = pango_parser;
1585       *data = parser_data;
1586       return TRUE;
1587     }
1588   return FALSE;
1589 }
1590
1591 static void
1592 gtk_label_buildable_custom_finished (GtkBuildable *buildable,
1593                                      GtkBuilder   *builder,
1594                                      GObject      *child,
1595                                      const gchar  *tagname,
1596                                      gpointer      user_data)
1597 {
1598   PangoParserData *data;
1599
1600   buildable_parent_iface->custom_finished (buildable, builder, child,
1601                                            tagname, user_data);
1602
1603   if (strcmp (tagname, "attributes") == 0)
1604     {
1605       data = (PangoParserData*)user_data;
1606
1607       if (data->attrs)
1608         {
1609           gtk_label_set_attributes (GTK_LABEL (buildable), data->attrs);
1610           pango_attr_list_unref (data->attrs);
1611         }
1612
1613       g_object_unref (data->object);
1614       g_object_unref (data->builder);
1615       g_slice_free (PangoParserData, data);
1616     }
1617 }
1618
1619
1620 /**
1621  * gtk_label_new:
1622  * @str: The text of the label
1623  *
1624  * Creates a new label with the given text inside it. You can
1625  * pass %NULL to get an empty label widget.
1626  *
1627  * Return value: the new #GtkLabel
1628  **/
1629 GtkWidget*
1630 gtk_label_new (const gchar *str)
1631 {
1632   GtkLabel *label;
1633
1634   label = g_object_new (GTK_TYPE_LABEL, NULL);
1635
1636   if (str && *str)
1637     gtk_label_set_text (label, str);
1638
1639   return GTK_WIDGET (label);
1640 }
1641
1642 /**
1643  * gtk_label_new_with_mnemonic:
1644  * @str: The text of the label, with an underscore in front of the
1645  *       mnemonic character
1646  *
1647  * Creates a new #GtkLabel, containing the text in @str.
1648  *
1649  * If characters in @str are preceded by an underscore, they are
1650  * underlined. If you need a literal underscore character in a label, use
1651  * '__' (two underscores). The first underlined character represents a
1652  * keyboard accelerator called a mnemonic. The mnemonic key can be used
1653  * to activate another widget, chosen automatically, or explicitly using
1654  * gtk_label_set_mnemonic_widget().
1655  *
1656  * If gtk_label_set_mnemonic_widget() is not called, then the first
1657  * activatable ancestor of the #GtkLabel will be chosen as the mnemonic
1658  * widget. For instance, if the label is inside a button or menu item,
1659  * the button or menu item will automatically become the mnemonic widget
1660  * and be activated by the mnemonic.
1661  *
1662  * Return value: the new #GtkLabel
1663  **/
1664 GtkWidget*
1665 gtk_label_new_with_mnemonic (const gchar *str)
1666 {
1667   GtkLabel *label;
1668
1669   label = g_object_new (GTK_TYPE_LABEL, NULL);
1670
1671   if (str && *str)
1672     gtk_label_set_text_with_mnemonic (label, str);
1673
1674   return GTK_WIDGET (label);
1675 }
1676
1677 static gboolean
1678 gtk_label_mnemonic_activate (GtkWidget *widget,
1679                              gboolean   group_cycling)
1680 {
1681   GtkLabel *label = GTK_LABEL (widget);
1682   GtkLabelPrivate *priv = label->priv;
1683   GtkWidget *parent;
1684
1685   if (priv->mnemonic_widget)
1686     return gtk_widget_mnemonic_activate (priv->mnemonic_widget, group_cycling);
1687
1688   /* Try to find the widget to activate by traversing the
1689    * widget's ancestry.
1690    */
1691   parent = gtk_widget_get_parent (widget);
1692
1693   if (GTK_IS_NOTEBOOK (parent))
1694     return FALSE;
1695
1696   while (parent)
1697     {
1698       if (gtk_widget_get_can_focus (parent) ||
1699           (!group_cycling && GTK_WIDGET_GET_CLASS (parent)->activate_signal) ||
1700           GTK_IS_NOTEBOOK (gtk_widget_get_parent (parent)) ||
1701           GTK_IS_MENU_ITEM (parent))
1702         return gtk_widget_mnemonic_activate (parent, group_cycling);
1703       parent = gtk_widget_get_parent (parent);
1704     }
1705
1706   /* barf if there was nothing to activate */
1707   g_warning ("Couldn't find a target for a mnemonic activation.");
1708   gtk_widget_error_bell (widget);
1709
1710   return FALSE;
1711 }
1712
1713 static void
1714 gtk_label_setup_mnemonic (GtkLabel *label,
1715                           guint     last_key)
1716 {
1717   GtkLabelPrivate *priv = label->priv;
1718   GtkWidget *widget = GTK_WIDGET (label);
1719   GtkWidget *toplevel;
1720   GtkWidget *mnemonic_menu;
1721
1722   mnemonic_menu = g_object_get_data (G_OBJECT (label), "gtk-mnemonic-menu");
1723
1724   if (last_key != GDK_KEY_VoidSymbol)
1725     {
1726       if (priv->mnemonic_window)
1727         {
1728           gtk_window_remove_mnemonic  (priv->mnemonic_window,
1729                                        last_key,
1730                                        widget);
1731           priv->mnemonic_window = NULL;
1732         }
1733       if (mnemonic_menu)
1734         {
1735           _gtk_menu_shell_remove_mnemonic (GTK_MENU_SHELL (mnemonic_menu),
1736                                            last_key,
1737                                            widget);
1738           mnemonic_menu = NULL;
1739         }
1740     }
1741
1742   if (priv->mnemonic_keyval == GDK_KEY_VoidSymbol)
1743       goto done;
1744
1745   connect_mnemonics_visible_notify (GTK_LABEL (widget));
1746
1747   toplevel = gtk_widget_get_toplevel (widget);
1748   if (gtk_widget_is_toplevel (toplevel))
1749     {
1750       GtkWidget *menu_shell;
1751
1752       menu_shell = gtk_widget_get_ancestor (widget,
1753                                             GTK_TYPE_MENU_SHELL);
1754
1755       if (menu_shell)
1756         {
1757           _gtk_menu_shell_add_mnemonic (GTK_MENU_SHELL (menu_shell),
1758                                         priv->mnemonic_keyval,
1759                                         widget);
1760           mnemonic_menu = menu_shell;
1761         }
1762
1763       if (!GTK_IS_MENU (menu_shell))
1764         {
1765           gtk_window_add_mnemonic (GTK_WINDOW (toplevel),
1766                                    priv->mnemonic_keyval,
1767                                    widget);
1768           priv->mnemonic_window = GTK_WINDOW (toplevel);
1769         }
1770     }
1771
1772  done:
1773   g_object_set_data (G_OBJECT (label), I_("gtk-mnemonic-menu"), mnemonic_menu);
1774 }
1775
1776 static void
1777 gtk_label_hierarchy_changed (GtkWidget *widget,
1778                              GtkWidget *old_toplevel)
1779 {
1780   GtkLabel *label = GTK_LABEL (widget);
1781   GtkLabelPrivate *priv = label->priv;
1782
1783   gtk_label_setup_mnemonic (label, priv->mnemonic_keyval);
1784 }
1785
1786 static void
1787 label_shortcut_setting_apply (GtkLabel *label)
1788 {
1789   gtk_label_recalculate (label);
1790   if (GTK_IS_ACCEL_LABEL (label))
1791     gtk_accel_label_refetch (GTK_ACCEL_LABEL (label));
1792 }
1793
1794 static void
1795 label_shortcut_setting_traverse_container (GtkWidget *widget,
1796                                            gpointer   data)
1797 {
1798   if (GTK_IS_LABEL (widget))
1799     label_shortcut_setting_apply (GTK_LABEL (widget));
1800   else if (GTK_IS_CONTAINER (widget))
1801     gtk_container_forall (GTK_CONTAINER (widget),
1802                           label_shortcut_setting_traverse_container, data);
1803 }
1804
1805 static void
1806 label_shortcut_setting_changed (GtkSettings *settings)
1807 {
1808   GList *list, *l;
1809
1810   list = gtk_window_list_toplevels ();
1811
1812   for (l = list; l ; l = l->next)
1813     {
1814       GtkWidget *widget = l->data;
1815
1816       if (gtk_widget_get_settings (widget) == settings)
1817         gtk_container_forall (GTK_CONTAINER (widget),
1818                               label_shortcut_setting_traverse_container, NULL);
1819     }
1820
1821   g_list_free (list);
1822 }
1823
1824 static void
1825 mnemonics_visible_apply (GtkWidget *widget,
1826                          gboolean   mnemonics_visible)
1827 {
1828   GtkLabel *label = GTK_LABEL (widget);
1829   GtkLabelPrivate *priv = label->priv;
1830
1831   mnemonics_visible = mnemonics_visible != FALSE;
1832
1833   if (priv->mnemonics_visible != mnemonics_visible)
1834     {
1835       priv->mnemonics_visible = mnemonics_visible;
1836
1837       gtk_label_recalculate (label);
1838     }
1839 }
1840
1841 static void
1842 label_mnemonics_visible_traverse_container (GtkWidget *widget,
1843                                             gpointer   data)
1844 {
1845   gboolean mnemonics_visible = GPOINTER_TO_INT (data);
1846
1847   _gtk_label_mnemonics_visible_apply_recursively (widget, mnemonics_visible);
1848 }
1849
1850 void
1851 _gtk_label_mnemonics_visible_apply_recursively (GtkWidget *widget,
1852                                                 gboolean   mnemonics_visible)
1853 {
1854   if (GTK_IS_LABEL (widget))
1855     mnemonics_visible_apply (widget, mnemonics_visible);
1856   else if (GTK_IS_CONTAINER (widget))
1857     gtk_container_forall (GTK_CONTAINER (widget),
1858                           label_mnemonics_visible_traverse_container,
1859                           GINT_TO_POINTER (mnemonics_visible));
1860 }
1861
1862 static void
1863 label_mnemonics_visible_changed (GtkWindow  *window,
1864                                  GParamSpec *pspec,
1865                                  gpointer    data)
1866 {
1867   gboolean mnemonics_visible;
1868
1869   g_object_get (window, "mnemonics-visible", &mnemonics_visible, NULL);
1870
1871   gtk_container_forall (GTK_CONTAINER (window),
1872                         label_mnemonics_visible_traverse_container,
1873                         GINT_TO_POINTER (mnemonics_visible));
1874 }
1875
1876 static void
1877 gtk_label_screen_changed (GtkWidget *widget,
1878                           GdkScreen *old_screen)
1879 {
1880   GtkSettings *settings;
1881   gboolean shortcuts_connected;
1882
1883   if (!gtk_widget_has_screen (widget))
1884     return;
1885
1886   settings = gtk_widget_get_settings (widget);
1887
1888   shortcuts_connected =
1889     GPOINTER_TO_INT (g_object_get_data (G_OBJECT (settings),
1890                                         "gtk-label-shortcuts-connected"));
1891
1892   if (! shortcuts_connected)
1893     {
1894       g_signal_connect (settings, "notify::gtk-enable-mnemonics",
1895                         G_CALLBACK (label_shortcut_setting_changed),
1896                         NULL);
1897       g_signal_connect (settings, "notify::gtk-enable-accels",
1898                         G_CALLBACK (label_shortcut_setting_changed),
1899                         NULL);
1900
1901       g_object_set_data (G_OBJECT (settings), "gtk-label-shortcuts-connected",
1902                          GINT_TO_POINTER (TRUE));
1903     }
1904
1905   label_shortcut_setting_apply (GTK_LABEL (widget));
1906 }
1907
1908
1909 static void
1910 label_mnemonic_widget_weak_notify (gpointer      data,
1911                                    GObject      *where_the_object_was)
1912 {
1913   GtkLabel *label = data;
1914   GtkLabelPrivate *priv = label->priv;
1915
1916   priv->mnemonic_widget = NULL;
1917   g_object_notify (G_OBJECT (label), "mnemonic-widget");
1918 }
1919
1920 /**
1921  * gtk_label_set_mnemonic_widget:
1922  * @label: a #GtkLabel
1923  * @widget: (allow-none): the target #GtkWidget
1924  *
1925  * If the label has been set so that it has an mnemonic key (using
1926  * i.e. gtk_label_set_markup_with_mnemonic(),
1927  * gtk_label_set_text_with_mnemonic(), gtk_label_new_with_mnemonic()
1928  * or the "use_underline" property) the label can be associated with a
1929  * widget that is the target of the mnemonic. When the label is inside
1930  * a widget (like a #GtkButton or a #GtkNotebook tab) it is
1931  * automatically associated with the correct widget, but sometimes
1932  * (i.e. when the target is a #GtkEntry next to the label) you need to
1933  * set it explicitly using this function.
1934  *
1935  * The target widget will be accelerated by emitting the
1936  * GtkWidget::mnemonic-activate signal on it. The default handler for
1937  * this signal will activate the widget if there are no mnemonic collisions
1938  * and toggle focus between the colliding widgets otherwise.
1939  **/
1940 void
1941 gtk_label_set_mnemonic_widget (GtkLabel  *label,
1942                                GtkWidget *widget)
1943 {
1944   GtkLabelPrivate *priv;
1945
1946   g_return_if_fail (GTK_IS_LABEL (label));
1947
1948   priv = label->priv;
1949
1950   if (widget)
1951     g_return_if_fail (GTK_IS_WIDGET (widget));
1952
1953   if (priv->mnemonic_widget)
1954     {
1955       gtk_widget_remove_mnemonic_label (priv->mnemonic_widget, GTK_WIDGET (label));
1956       g_object_weak_unref (G_OBJECT (priv->mnemonic_widget),
1957                            label_mnemonic_widget_weak_notify,
1958                            label);
1959     }
1960   priv->mnemonic_widget = widget;
1961   if (priv->mnemonic_widget)
1962     {
1963       g_object_weak_ref (G_OBJECT (priv->mnemonic_widget),
1964                          label_mnemonic_widget_weak_notify,
1965                          label);
1966       gtk_widget_add_mnemonic_label (priv->mnemonic_widget, GTK_WIDGET (label));
1967     }
1968
1969   g_object_notify (G_OBJECT (label), "mnemonic-widget");
1970 }
1971
1972 /**
1973  * gtk_label_get_mnemonic_widget:
1974  * @label: a #GtkLabel
1975  *
1976  * Retrieves the target of the mnemonic (keyboard shortcut) of this
1977  * label. See gtk_label_set_mnemonic_widget().
1978  *
1979  * Return value: (transfer none): the target of the label's mnemonic,
1980  *     or %NULL if none has been set and the default algorithm will be used.
1981  **/
1982 GtkWidget *
1983 gtk_label_get_mnemonic_widget (GtkLabel *label)
1984 {
1985   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
1986
1987   return label->priv->mnemonic_widget;
1988 }
1989
1990 /**
1991  * gtk_label_get_mnemonic_keyval:
1992  * @label: a #GtkLabel
1993  *
1994  * If the label has been set so that it has an mnemonic key this function
1995  * returns the keyval used for the mnemonic accelerator. If there is no
1996  * mnemonic set up it returns #GDK_VoidSymbol.
1997  *
1998  * Returns: GDK keyval usable for accelerators, or #GDK_VoidSymbol
1999  **/
2000 guint
2001 gtk_label_get_mnemonic_keyval (GtkLabel *label)
2002 {
2003   g_return_val_if_fail (GTK_IS_LABEL (label), GDK_KEY_VoidSymbol);
2004
2005   return label->priv->mnemonic_keyval;
2006 }
2007
2008 static void
2009 gtk_label_set_text_internal (GtkLabel *label,
2010                              gchar    *str)
2011 {
2012   GtkLabelPrivate *priv = label->priv;
2013
2014   g_free (priv->text);
2015
2016   priv->text = str;
2017
2018   gtk_label_select_region_index (label, 0, 0);
2019 }
2020
2021 static void
2022 gtk_label_set_label_internal (GtkLabel *label,
2023                               gchar    *str)
2024 {
2025   GtkLabelPrivate *priv = label->priv;
2026
2027   g_free (priv->label);
2028
2029   priv->label = str;
2030
2031   g_object_notify (G_OBJECT (label), "label");
2032 }
2033
2034 static void
2035 gtk_label_set_use_markup_internal (GtkLabel *label,
2036                                    gboolean  val)
2037 {
2038   GtkLabelPrivate *priv = label->priv;
2039
2040   val = val != FALSE;
2041   if (priv->use_markup != val)
2042     {
2043       priv->use_markup = val;
2044
2045       g_object_notify (G_OBJECT (label), "use-markup");
2046     }
2047 }
2048
2049 static void
2050 gtk_label_set_use_underline_internal (GtkLabel *label,
2051                                       gboolean val)
2052 {
2053   GtkLabelPrivate *priv = label->priv;
2054
2055   val = val != FALSE;
2056   if (priv->use_underline != val)
2057     {
2058       priv->use_underline = val;
2059
2060       g_object_notify (G_OBJECT (label), "use-underline");
2061     }
2062 }
2063
2064 static void
2065 gtk_label_compose_effective_attrs (GtkLabel *label)
2066 {
2067   GtkLabelPrivate      *priv = label->priv;
2068   PangoAttrIterator *iter;
2069   PangoAttribute    *attr;
2070   GSList            *iter_attrs, *l;
2071
2072   if (priv->attrs)
2073     {
2074       if (priv->effective_attrs)
2075         {
2076           if ((iter = pango_attr_list_get_iterator (priv->attrs)))
2077             {
2078               do
2079                 {
2080                   iter_attrs = pango_attr_iterator_get_attrs (iter);
2081                   for (l = iter_attrs; l; l = l->next)
2082                     {
2083                       attr = l->data;
2084                       pango_attr_list_insert (priv->effective_attrs, attr);
2085                     }
2086                   g_slist_free (iter_attrs);
2087                 }
2088               while (pango_attr_iterator_next (iter));
2089               pango_attr_iterator_destroy (iter);
2090             }
2091         }
2092       else
2093         priv->effective_attrs =
2094           pango_attr_list_ref (priv->attrs);
2095     }
2096 }
2097
2098 static void
2099 gtk_label_set_attributes_internal (GtkLabel      *label,
2100                                    PangoAttrList *attrs)
2101 {
2102   GtkLabelPrivate *priv = label->priv;
2103
2104   if (attrs)
2105     pango_attr_list_ref (attrs);
2106
2107   if (priv->attrs)
2108     pango_attr_list_unref (priv->attrs);
2109   priv->attrs = attrs;
2110
2111   g_object_notify (G_OBJECT (label), "attributes");
2112 }
2113
2114
2115 /* Calculates text, attrs and mnemonic_keyval from
2116  * label, use_underline and use_markup
2117  */
2118 static void
2119 gtk_label_recalculate (GtkLabel *label)
2120 {
2121   GtkLabelPrivate *priv = label->priv;
2122   guint keyval = priv->mnemonic_keyval;
2123
2124   if (priv->use_markup)
2125     gtk_label_set_markup_internal (label, priv->label, priv->use_underline);
2126   else
2127     {
2128       if (priv->use_underline)
2129         gtk_label_set_uline_text_internal (label, priv->label);
2130       else
2131         {
2132           if (priv->effective_attrs)
2133             pango_attr_list_unref (priv->effective_attrs);
2134           priv->effective_attrs = NULL;
2135           gtk_label_set_text_internal (label, g_strdup (priv->label));
2136         }
2137     }
2138
2139   gtk_label_compose_effective_attrs (label);
2140
2141   if (!priv->use_underline)
2142     priv->mnemonic_keyval = GDK_KEY_VoidSymbol;
2143
2144   if (keyval != priv->mnemonic_keyval)
2145     {
2146       gtk_label_setup_mnemonic (label, keyval);
2147       g_object_notify (G_OBJECT (label), "mnemonic-keyval");
2148     }
2149
2150   gtk_label_clear_layout (label);
2151   gtk_label_clear_select_info (label);
2152   gtk_widget_queue_resize (GTK_WIDGET (label));
2153 }
2154
2155 /**
2156  * gtk_label_set_text:
2157  * @label: a #GtkLabel
2158  * @str: The text you want to set
2159  *
2160  * Sets the text within the #GtkLabel widget. It overwrites any text that
2161  * was there before.
2162  *
2163  * This will also clear any previously set mnemonic accelerators.
2164  **/
2165 void
2166 gtk_label_set_text (GtkLabel    *label,
2167                     const gchar *str)
2168 {
2169   g_return_if_fail (GTK_IS_LABEL (label));
2170
2171   g_object_freeze_notify (G_OBJECT (label));
2172
2173   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
2174   gtk_label_set_use_markup_internal (label, FALSE);
2175   gtk_label_set_use_underline_internal (label, FALSE);
2176
2177   gtk_label_recalculate (label);
2178
2179   g_object_thaw_notify (G_OBJECT (label));
2180 }
2181
2182 /**
2183  * gtk_label_set_attributes:
2184  * @label: a #GtkLabel
2185  * @attrs: a #PangoAttrList
2186  *
2187  * Sets a #PangoAttrList; the attributes in the list are applied to the
2188  * label text.
2189  *
2190  * <note><para>The attributes set with this function will be applied
2191  * and merged with any other attributes previously effected by way
2192  * of the #GtkLabel:use-underline or #GtkLabel:use-markup properties.
2193  * While it is not recommended to mix markup strings with manually set
2194  * attributes, if you must; know that the attributes will be applied
2195  * to the label after the markup string is parsed.</para></note>
2196  **/
2197 void
2198 gtk_label_set_attributes (GtkLabel         *label,
2199                           PangoAttrList    *attrs)
2200 {
2201   g_return_if_fail (GTK_IS_LABEL (label));
2202
2203   gtk_label_set_attributes_internal (label, attrs);
2204
2205   gtk_label_recalculate (label);
2206
2207   gtk_label_clear_layout (label);
2208   gtk_widget_queue_resize (GTK_WIDGET (label));
2209 }
2210
2211 /**
2212  * gtk_label_get_attributes:
2213  * @label: a #GtkLabel
2214  *
2215  * Gets the attribute list that was set on the label using
2216  * gtk_label_set_attributes(), if any. This function does
2217  * not reflect attributes that come from the labels markup
2218  * (see gtk_label_set_markup()). If you want to get the
2219  * effective attributes for the label, use
2220  * pango_layout_get_attribute (gtk_label_get_layout (label)).
2221  *
2222  * Return value: (transfer none): the attribute list, or %NULL
2223  *     if none was set.
2224  **/
2225 PangoAttrList *
2226 gtk_label_get_attributes (GtkLabel *label)
2227 {
2228   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
2229
2230   return label->priv->attrs;
2231 }
2232
2233 /**
2234  * gtk_label_set_label:
2235  * @label: a #GtkLabel
2236  * @str: the new text to set for the label
2237  *
2238  * Sets the text of the label. The label is interpreted as
2239  * including embedded underlines and/or Pango markup depending
2240  * on the values of the #GtkLabel:use-underline" and
2241  * #GtkLabel:use-markup properties.
2242  **/
2243 void
2244 gtk_label_set_label (GtkLabel    *label,
2245                      const gchar *str)
2246 {
2247   g_return_if_fail (GTK_IS_LABEL (label));
2248
2249   g_object_freeze_notify (G_OBJECT (label));
2250
2251   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
2252   gtk_label_recalculate (label);
2253
2254   g_object_thaw_notify (G_OBJECT (label));
2255 }
2256
2257 /**
2258  * gtk_label_get_label:
2259  * @label: a #GtkLabel
2260  *
2261  * Fetches the text from a label widget including any embedded
2262  * underlines indicating mnemonics and Pango markup. (See
2263  * gtk_label_get_text()).
2264  *
2265  * Return value: the text of the label widget. This string is
2266  *   owned by the widget and must not be modified or freed.
2267  **/
2268 G_CONST_RETURN gchar *
2269 gtk_label_get_label (GtkLabel *label)
2270 {
2271   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
2272
2273   return label->priv->label;
2274 }
2275
2276 typedef struct
2277 {
2278   GtkLabel *label;
2279   GList *links;
2280   GString *new_str;
2281   GdkColor *link_color;
2282   GdkColor *visited_link_color;
2283 } UriParserData;
2284
2285 static void
2286 start_element_handler (GMarkupParseContext  *context,
2287                        const gchar          *element_name,
2288                        const gchar         **attribute_names,
2289                        const gchar         **attribute_values,
2290                        gpointer              user_data,
2291                        GError              **error)
2292 {
2293   GtkLabelPrivate *priv;
2294   UriParserData *pdata = user_data;
2295
2296   if (strcmp (element_name, "a") == 0)
2297     {
2298       GtkLabelLink *link;
2299       const gchar *uri = NULL;
2300       const gchar *title = NULL;
2301       gboolean visited = FALSE;
2302       gint line_number;
2303       gint char_number;
2304       gint i;
2305       GdkColor *color = NULL;
2306
2307       g_markup_parse_context_get_position (context, &line_number, &char_number);
2308
2309       for (i = 0; attribute_names[i] != NULL; i++)
2310         {
2311           const gchar *attr = attribute_names[i];
2312
2313           if (strcmp (attr, "href") == 0)
2314             uri = attribute_values[i];
2315           else if (strcmp (attr, "title") == 0)
2316             title = attribute_values[i];
2317           else
2318             {
2319               g_set_error (error,
2320                            G_MARKUP_ERROR,
2321                            G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE,
2322                            "Attribute '%s' is not allowed on the <a> tag "
2323                            "on line %d char %d",
2324                             attr, line_number, char_number);
2325               return;
2326             }
2327         }
2328
2329       if (uri == NULL)
2330         {
2331           g_set_error (error,
2332                        G_MARKUP_ERROR,
2333                        G_MARKUP_ERROR_INVALID_CONTENT,
2334                        "Attribute 'href' was missing on the <a> tag "
2335                        "on line %d char %d",
2336                        line_number, char_number);
2337           return;
2338         }
2339
2340       visited = FALSE;
2341       priv = pdata->label->priv;
2342       if (priv->track_links && priv->select_info)
2343         {
2344           GList *l;
2345           for (l = priv->select_info->links; l; l = l->next)
2346             {
2347               link = l->data;
2348               if (strcmp (uri, link->uri) == 0)
2349                 {
2350                   visited = link->visited;
2351                   break;
2352                 }
2353             }
2354         }
2355
2356       if (visited)
2357         color = pdata->visited_link_color;
2358       else
2359         color = pdata->link_color;
2360
2361       g_string_append_printf (pdata->new_str,
2362                               "<span color=\"#%04x%04x%04x\" underline=\"single\">",
2363                               color->red,
2364                               color->green,
2365                               color->blue);
2366
2367       link = g_new0 (GtkLabelLink, 1);
2368       link->uri = g_strdup (uri);
2369       link->title = g_strdup (title);
2370       link->visited = visited;
2371       pdata->links = g_list_append (pdata->links, link);
2372     }
2373   else
2374     {
2375       gint i;
2376
2377       g_string_append_c (pdata->new_str, '<');
2378       g_string_append (pdata->new_str, element_name);
2379
2380       for (i = 0; attribute_names[i] != NULL; i++)
2381         {
2382           const gchar *attr  = attribute_names[i];
2383           const gchar *value = attribute_values[i];
2384           gchar *newvalue;
2385
2386           newvalue = g_markup_escape_text (value, -1);
2387
2388           g_string_append_c (pdata->new_str, ' ');
2389           g_string_append (pdata->new_str, attr);
2390           g_string_append (pdata->new_str, "=\"");
2391           g_string_append (pdata->new_str, newvalue);
2392           g_string_append_c (pdata->new_str, '\"');
2393
2394           g_free (newvalue);
2395         }
2396       g_string_append_c (pdata->new_str, '>');
2397     }
2398 }
2399
2400 static void
2401 end_element_handler (GMarkupParseContext  *context,
2402                      const gchar          *element_name,
2403                      gpointer              user_data,
2404                      GError              **error)
2405 {
2406   UriParserData *pdata = user_data;
2407
2408   if (!strcmp (element_name, "a"))
2409     g_string_append (pdata->new_str, "</span>");
2410   else
2411     {
2412       g_string_append (pdata->new_str, "</");
2413       g_string_append (pdata->new_str, element_name);
2414       g_string_append_c (pdata->new_str, '>');
2415     }
2416 }
2417
2418 static void
2419 text_handler (GMarkupParseContext  *context,
2420               const gchar          *text,
2421               gsize                 text_len,
2422               gpointer              user_data,
2423               GError              **error)
2424 {
2425   UriParserData *pdata = user_data;
2426   gchar *newtext;
2427
2428   newtext = g_markup_escape_text (text, text_len);
2429   g_string_append (pdata->new_str, newtext);
2430   g_free (newtext);
2431 }
2432
2433 static const GMarkupParser markup_parser =
2434 {
2435   start_element_handler,
2436   end_element_handler,
2437   text_handler,
2438   NULL,
2439   NULL
2440 };
2441
2442 static gboolean
2443 xml_isspace (gchar c)
2444 {
2445   return (c == ' ' || c == '\t' || c == '\n' || c == '\r');
2446 }
2447
2448 static void
2449 link_free (GtkLabelLink *link)
2450 {
2451   g_free (link->uri);
2452   g_free (link->title);
2453   g_free (link);
2454 }
2455
2456 static void
2457 gtk_label_get_link_colors (GtkWidget  *widget,
2458                            GdkColor  **link_color,
2459                            GdkColor  **visited_link_color)
2460 {
2461   GtkStyleContext *context;
2462
2463   context = gtk_widget_get_style_context (widget);
2464   gtk_style_context_get_style (context,
2465                                "link-color", link_color,
2466                                "visited-link-color", visited_link_color,
2467                                 NULL);
2468   if (!*link_color)
2469     *link_color = gdk_color_copy (&default_link_color);
2470   if (!*visited_link_color)
2471     *visited_link_color = gdk_color_copy (&default_visited_link_color);
2472 }
2473
2474 static gboolean
2475 parse_uri_markup (GtkLabel     *label,
2476                   const gchar  *str,
2477                   gchar       **new_str,
2478                   GList       **links,
2479                   GError      **error)
2480 {
2481   GMarkupParseContext *context = NULL;
2482   const gchar *p, *end;
2483   gboolean needs_root = TRUE;
2484   gsize length;
2485   UriParserData pdata;
2486
2487   length = strlen (str);
2488   p = str;
2489   end = str + length;
2490
2491   pdata.label = label;
2492   pdata.links = NULL;
2493   pdata.new_str = g_string_sized_new (length);
2494
2495   gtk_label_get_link_colors (GTK_WIDGET (label), &pdata.link_color, &pdata.visited_link_color);
2496
2497   while (p != end && xml_isspace (*p))
2498     p++;
2499
2500   if (end - p >= 8 && strncmp (p, "<markup>", 8) == 0)
2501     needs_root = FALSE;
2502
2503   context = g_markup_parse_context_new (&markup_parser, 0, &pdata, NULL);
2504
2505   if (needs_root)
2506     {
2507       if (!g_markup_parse_context_parse (context, "<markup>", -1, error))
2508         goto failed;
2509     }
2510
2511   if (!g_markup_parse_context_parse (context, str, length, error))
2512     goto failed;
2513
2514   if (needs_root)
2515     {
2516       if (!g_markup_parse_context_parse (context, "</markup>", -1, error))
2517         goto failed;
2518     }
2519
2520   if (!g_markup_parse_context_end_parse (context, error))
2521     goto failed;
2522
2523   g_markup_parse_context_free (context);
2524
2525   *new_str = g_string_free (pdata.new_str, FALSE);
2526   *links = pdata.links;
2527
2528   gdk_color_free (pdata.link_color);
2529   gdk_color_free (pdata.visited_link_color);
2530
2531   return TRUE;
2532
2533 failed:
2534   g_markup_parse_context_free (context);
2535   g_string_free (pdata.new_str, TRUE);
2536   g_list_foreach (pdata.links, (GFunc)link_free, NULL);
2537   g_list_free (pdata.links);
2538   gdk_color_free (pdata.link_color);
2539   gdk_color_free (pdata.visited_link_color);
2540
2541   return FALSE;
2542 }
2543
2544 static void
2545 gtk_label_ensure_has_tooltip (GtkLabel *label)
2546 {
2547   GtkLabelPrivate *priv = label->priv;
2548   GList *l;
2549   gboolean has_tooltip = FALSE;
2550
2551   for (l = priv->select_info->links; l; l = l->next)
2552     {
2553       GtkLabelLink *link = l->data;
2554       if (link->title)
2555         {
2556           has_tooltip = TRUE;
2557           break;
2558         }
2559     }
2560
2561   gtk_widget_set_has_tooltip (GTK_WIDGET (label), has_tooltip);
2562 }
2563
2564 static void
2565 gtk_label_set_markup_internal (GtkLabel    *label,
2566                                const gchar *str,
2567                                gboolean     with_uline)
2568 {
2569   GtkLabelPrivate *priv = label->priv;
2570   gchar *text = NULL;
2571   GError *error = NULL;
2572   PangoAttrList *attrs = NULL;
2573   gunichar accel_char = 0;
2574   gchar *new_str;
2575   GList *links = NULL;
2576
2577   if (!parse_uri_markup (label, str, &new_str, &links, &error))
2578     {
2579       g_warning ("Failed to set text from markup due to error parsing markup: %s",
2580                  error->message);
2581       g_error_free (error);
2582       return;
2583     }
2584
2585   gtk_label_clear_links (label);
2586   if (links)
2587     {
2588       gtk_label_ensure_select_info (label);
2589       priv->select_info->links = links;
2590       gtk_label_ensure_has_tooltip (label);
2591     }
2592
2593   if (with_uline)
2594     {
2595       gboolean enable_mnemonics;
2596       gboolean auto_mnemonics;
2597
2598       g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
2599                     "gtk-enable-mnemonics", &enable_mnemonics,
2600                     "gtk-auto-mnemonics", &auto_mnemonics,
2601                     NULL);
2602
2603       if (!(enable_mnemonics && priv->mnemonics_visible &&
2604             (!auto_mnemonics ||
2605              (gtk_widget_is_sensitive (GTK_WIDGET (label)) &&
2606               (!priv->mnemonic_widget ||
2607                gtk_widget_is_sensitive (priv->mnemonic_widget))))))
2608         {
2609           gchar *tmp;
2610           gchar *pattern;
2611           guint key;
2612
2613           if (separate_uline_pattern (new_str, &key, &tmp, &pattern))
2614             {
2615               g_free (new_str);
2616               new_str = tmp;
2617               g_free (pattern);
2618             }
2619         }
2620     }
2621
2622   if (!pango_parse_markup (new_str,
2623                            -1,
2624                            with_uline ? '_' : 0,
2625                            &attrs,
2626                            &text,
2627                            with_uline ? &accel_char : NULL,
2628                            &error))
2629     {
2630       g_warning ("Failed to set text from markup due to error parsing markup: %s",
2631                  error->message);
2632       g_free (new_str);
2633       g_error_free (error);
2634       return;
2635     }
2636
2637   g_free (new_str);
2638
2639   if (text)
2640     gtk_label_set_text_internal (label, text);
2641
2642   if (attrs)
2643     {
2644       if (priv->effective_attrs)
2645         pango_attr_list_unref (priv->effective_attrs);
2646       priv->effective_attrs = attrs;
2647     }
2648
2649   if (accel_char != 0)
2650     priv->mnemonic_keyval = gdk_keyval_to_lower (gdk_unicode_to_keyval (accel_char));
2651   else
2652     priv->mnemonic_keyval = GDK_KEY_VoidSymbol;
2653 }
2654
2655 /**
2656  * gtk_label_set_markup:
2657  * @label: a #GtkLabel
2658  * @str: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
2659  *
2660  * Parses @str which is marked up with the <link
2661  * linkend="PangoMarkupFormat">Pango text markup language</link>, setting the
2662  * label's text and attribute list based on the parse results. If the @str is
2663  * external data, you may need to escape it with g_markup_escape_text() or
2664  * g_markup_printf_escaped()<!-- -->:
2665  * |[
2666  * char *markup;
2667  *
2668  * markup = g_markup_printf_escaped ("&lt;span style=\"italic\"&gt;&percnt;s&lt;/span&gt;", str);
2669  * gtk_label_set_markup (GTK_LABEL (label), markup);
2670  * g_free (markup);
2671  * ]|
2672  **/
2673 void
2674 gtk_label_set_markup (GtkLabel    *label,
2675                       const gchar *str)
2676 {
2677   g_return_if_fail (GTK_IS_LABEL (label));
2678
2679   g_object_freeze_notify (G_OBJECT (label));
2680
2681   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
2682   gtk_label_set_use_markup_internal (label, TRUE);
2683   gtk_label_set_use_underline_internal (label, FALSE);
2684
2685   gtk_label_recalculate (label);
2686
2687   g_object_thaw_notify (G_OBJECT (label));
2688 }
2689
2690 /**
2691  * gtk_label_set_markup_with_mnemonic:
2692  * @label: a #GtkLabel
2693  * @str: a markup string (see
2694  *     <link linkend="PangoMarkupFormat">Pango markup format</link>)
2695  *
2696  * Parses @str which is marked up with the
2697  * <link linkend="PangoMarkupFormat">Pango text markup language</link>,
2698  * setting the label's text and attribute list based on the parse results.
2699  * If characters in @str are preceded by an underscore, they are underlined
2700  * indicating that they represent a keyboard accelerator called a mnemonic.
2701  *
2702  * The mnemonic key can be used to activate another widget, chosen
2703  * automatically, or explicitly using gtk_label_set_mnemonic_widget().
2704  */
2705 void
2706 gtk_label_set_markup_with_mnemonic (GtkLabel    *label,
2707                                     const gchar *str)
2708 {
2709   g_return_if_fail (GTK_IS_LABEL (label));
2710
2711   g_object_freeze_notify (G_OBJECT (label));
2712
2713   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
2714   gtk_label_set_use_markup_internal (label, TRUE);
2715   gtk_label_set_use_underline_internal (label, TRUE);
2716
2717   gtk_label_recalculate (label);
2718
2719   g_object_thaw_notify (G_OBJECT (label));
2720 }
2721
2722 /**
2723  * gtk_label_get_text:
2724  * @label: a #GtkLabel
2725  *
2726  * Fetches the text from a label widget, as displayed on the
2727  * screen. This does not include any embedded underlines
2728  * indicating mnemonics or Pango markup. (See gtk_label_get_label())
2729  *
2730  * Return value: the text in the label widget. This is the internal
2731  *   string used by the label, and must not be modified.
2732  **/
2733 G_CONST_RETURN gchar *
2734 gtk_label_get_text (GtkLabel *label)
2735 {
2736   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
2737
2738   return label->priv->text;
2739 }
2740
2741 static PangoAttrList *
2742 gtk_label_pattern_to_attrs (GtkLabel      *label,
2743                             const gchar   *pattern)
2744 {
2745   GtkLabelPrivate *priv = label->priv;
2746   const char *start;
2747   const char *p = priv->text;
2748   const char *q = pattern;
2749   PangoAttrList *attrs;
2750
2751   attrs = pango_attr_list_new ();
2752
2753   while (1)
2754     {
2755       while (*p && *q && *q != '_')
2756         {
2757           p = g_utf8_next_char (p);
2758           q++;
2759         }
2760       start = p;
2761       while (*p && *q && *q == '_')
2762         {
2763           p = g_utf8_next_char (p);
2764           q++;
2765         }
2766
2767       if (p > start)
2768         {
2769           PangoAttribute *attr = pango_attr_underline_new (PANGO_UNDERLINE_LOW);
2770           attr->start_index = start - priv->text;
2771           attr->end_index = p - priv->text;
2772
2773           pango_attr_list_insert (attrs, attr);
2774         }
2775       else
2776         break;
2777     }
2778
2779   return attrs;
2780 }
2781
2782 static void
2783 gtk_label_set_pattern_internal (GtkLabel    *label,
2784                                 const gchar *pattern,
2785                                 gboolean     is_mnemonic)
2786 {
2787   GtkLabelPrivate *priv = label->priv;
2788   PangoAttrList *attrs;
2789   gboolean enable_mnemonics;
2790   gboolean auto_mnemonics;
2791
2792   if (priv->pattern_set)
2793     return;
2794
2795   if (is_mnemonic)
2796     {
2797       g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
2798                     "gtk-enable-mnemonics", &enable_mnemonics,
2799                     "gtk-auto-mnemonics", &auto_mnemonics,
2800                     NULL);
2801
2802       if (enable_mnemonics && priv->mnemonics_visible && pattern &&
2803           (!auto_mnemonics ||
2804            (gtk_widget_is_sensitive (GTK_WIDGET (label)) &&
2805             (!priv->mnemonic_widget ||
2806              gtk_widget_is_sensitive (priv->mnemonic_widget)))))
2807         attrs = gtk_label_pattern_to_attrs (label, pattern);
2808       else
2809         attrs = NULL;
2810     }
2811   else
2812     attrs = gtk_label_pattern_to_attrs (label, pattern);
2813
2814   if (priv->effective_attrs)
2815     pango_attr_list_unref (priv->effective_attrs);
2816   priv->effective_attrs = attrs;
2817 }
2818
2819 /**
2820  * gtk_label_set_pattern:
2821  * @label: The #GtkLabel you want to set the pattern to.
2822  * @pattern: The pattern as described above.
2823  *
2824  * The pattern of underlines you want under the existing text within the
2825  * #GtkLabel widget.  For example if the current text of the label says
2826  * "FooBarBaz" passing a pattern of "___   ___" will underline
2827  * "Foo" and "Baz" but not "Bar".
2828  */
2829 void
2830 gtk_label_set_pattern (GtkLabel    *label,
2831                        const gchar *pattern)
2832 {
2833   GtkLabelPrivate *priv = label->priv;
2834
2835   g_return_if_fail (GTK_IS_LABEL (label));
2836
2837   priv = label->priv;
2838
2839   priv->pattern_set = FALSE;
2840
2841   if (pattern)
2842     {
2843       gtk_label_set_pattern_internal (label, pattern, FALSE);
2844       priv->pattern_set = TRUE;
2845     }
2846   else
2847     gtk_label_recalculate (label);
2848
2849   gtk_label_clear_layout (label);
2850   gtk_widget_queue_resize (GTK_WIDGET (label));
2851 }
2852
2853
2854 /**
2855  * gtk_label_set_justify:
2856  * @label: a #GtkLabel
2857  * @jtype: a #GtkJustification
2858  *
2859  * Sets the alignment of the lines in the text of the label relative to
2860  * each other. %GTK_JUSTIFY_LEFT is the default value when the
2861  * widget is first created with gtk_label_new(). If you instead want
2862  * to set the alignment of the label as a whole, use
2863  * gtk_misc_set_alignment() instead. gtk_label_set_justify() has no
2864  * effect on labels containing only a single line.
2865  **/
2866 void
2867 gtk_label_set_justify (GtkLabel        *label,
2868                        GtkJustification jtype)
2869 {
2870   GtkLabelPrivate *priv;
2871
2872   g_return_if_fail (GTK_IS_LABEL (label));
2873   g_return_if_fail (jtype >= GTK_JUSTIFY_LEFT && jtype <= GTK_JUSTIFY_FILL);
2874
2875   priv = label->priv;
2876
2877   if ((GtkJustification) priv->jtype != jtype)
2878     {
2879       priv->jtype = jtype;
2880
2881       /* No real need to be this drastic, but easier than duplicating the code */
2882       gtk_label_clear_layout (label);
2883
2884       g_object_notify (G_OBJECT (label), "justify");
2885       gtk_widget_queue_resize (GTK_WIDGET (label));
2886     }
2887 }
2888
2889 /**
2890  * gtk_label_get_justify:
2891  * @label: a #GtkLabel
2892  *
2893  * Returns the justification of the label. See gtk_label_set_justify().
2894  *
2895  * Return value: #GtkJustification
2896  **/
2897 GtkJustification
2898 gtk_label_get_justify (GtkLabel *label)
2899 {
2900   g_return_val_if_fail (GTK_IS_LABEL (label), 0);
2901
2902   return label->priv->jtype;
2903 }
2904
2905 /**
2906  * gtk_label_set_ellipsize:
2907  * @label: a #GtkLabel
2908  * @mode: a #PangoEllipsizeMode
2909  *
2910  * Sets the mode used to ellipsize (add an ellipsis: "...") to the text
2911  * if there is not enough space to render the entire string.
2912  *
2913  * Since: 2.6
2914  **/
2915 void
2916 gtk_label_set_ellipsize (GtkLabel          *label,
2917                          PangoEllipsizeMode mode)
2918 {
2919   GtkLabelPrivate *priv;
2920
2921   g_return_if_fail (GTK_IS_LABEL (label));
2922   g_return_if_fail (mode >= PANGO_ELLIPSIZE_NONE && mode <= PANGO_ELLIPSIZE_END);
2923
2924   priv = label->priv;
2925
2926   if ((PangoEllipsizeMode) priv->ellipsize != mode)
2927     {
2928       priv->ellipsize = mode;
2929
2930       /* No real need to be this drastic, but easier than duplicating the code */
2931       gtk_label_clear_layout (label);
2932
2933       g_object_notify (G_OBJECT (label), "ellipsize");
2934       gtk_widget_queue_resize (GTK_WIDGET (label));
2935     }
2936 }
2937
2938 /**
2939  * gtk_label_get_ellipsize:
2940  * @label: a #GtkLabel
2941  *
2942  * Returns the ellipsizing position of the label. See gtk_label_set_ellipsize().
2943  *
2944  * Return value: #PangoEllipsizeMode
2945  *
2946  * Since: 2.6
2947  **/
2948 PangoEllipsizeMode
2949 gtk_label_get_ellipsize (GtkLabel *label)
2950 {
2951   g_return_val_if_fail (GTK_IS_LABEL (label), PANGO_ELLIPSIZE_NONE);
2952
2953   return label->priv->ellipsize;
2954 }
2955
2956 /**
2957  * gtk_label_set_width_chars:
2958  * @label: a #GtkLabel
2959  * @n_chars: the new desired width, in characters.
2960  *
2961  * Sets the desired width in characters of @label to @n_chars.
2962  *
2963  * Since: 2.6
2964  **/
2965 void
2966 gtk_label_set_width_chars (GtkLabel *label,
2967                            gint      n_chars)
2968 {
2969   GtkLabelPrivate *priv;
2970
2971   g_return_if_fail (GTK_IS_LABEL (label));
2972
2973   priv = label->priv;
2974
2975   if (priv->width_chars != n_chars)
2976     {
2977       priv->width_chars = n_chars;
2978       g_object_notify (G_OBJECT (label), "width-chars");
2979       gtk_widget_queue_resize (GTK_WIDGET (label));
2980     }
2981 }
2982
2983 /**
2984  * gtk_label_get_width_chars:
2985  * @label: a #GtkLabel
2986  *
2987  * Retrieves the desired width of @label, in characters. See
2988  * gtk_label_set_width_chars().
2989  *
2990  * Return value: the width of the label in characters.
2991  *
2992  * Since: 2.6
2993  **/
2994 gint
2995 gtk_label_get_width_chars (GtkLabel *label)
2996 {
2997   g_return_val_if_fail (GTK_IS_LABEL (label), -1);
2998
2999   return label->priv->width_chars;
3000 }
3001
3002 /**
3003  * gtk_label_set_max_width_chars:
3004  * @label: a #GtkLabel
3005  * @n_chars: the new desired maximum width, in characters.
3006  *
3007  * Sets the desired maximum width in characters of @label to @n_chars.
3008  *
3009  * Since: 2.6
3010  **/
3011 void
3012 gtk_label_set_max_width_chars (GtkLabel *label,
3013                                gint      n_chars)
3014 {
3015   GtkLabelPrivate *priv;
3016
3017   g_return_if_fail (GTK_IS_LABEL (label));
3018
3019   priv = label->priv;
3020
3021   if (priv->max_width_chars != n_chars)
3022     {
3023       priv->max_width_chars = n_chars;
3024
3025       g_object_notify (G_OBJECT (label), "max-width-chars");
3026       gtk_widget_queue_resize (GTK_WIDGET (label));
3027     }
3028 }
3029
3030 /**
3031  * gtk_label_get_max_width_chars:
3032  * @label: a #GtkLabel
3033  *
3034  * Retrieves the desired maximum width of @label, in characters. See
3035  * gtk_label_set_width_chars().
3036  *
3037  * Return value: the maximum width of the label in characters.
3038  *
3039  * Since: 2.6
3040  **/
3041 gint
3042 gtk_label_get_max_width_chars (GtkLabel *label)
3043 {
3044   g_return_val_if_fail (GTK_IS_LABEL (label), -1);
3045
3046   return label->priv->max_width_chars;
3047 }
3048
3049 /**
3050  * gtk_label_set_line_wrap:
3051  * @label: a #GtkLabel
3052  * @wrap: the setting
3053  *
3054  * Toggles line wrapping within the #GtkLabel widget. %TRUE makes it break
3055  * lines if text exceeds the widget's size. %FALSE lets the text get cut off
3056  * by the edge of the widget if it exceeds the widget size.
3057  *
3058  * Note that setting line wrapping to %TRUE does not make the label
3059  * wrap at its parent container's width, because GTK+ widgets
3060  * conceptually can't make their requisition depend on the parent
3061  * container's size. For a label that wraps at a specific position,
3062  * set the label's width using gtk_widget_set_size_request().
3063  **/
3064 void
3065 gtk_label_set_line_wrap (GtkLabel *label,
3066                          gboolean  wrap)
3067 {
3068   GtkLabelPrivate *priv;
3069
3070   g_return_if_fail (GTK_IS_LABEL (label));
3071
3072   priv = label->priv;
3073
3074   wrap = wrap != FALSE;
3075
3076   if (priv->wrap != wrap)
3077     {
3078       priv->wrap = wrap;
3079
3080       gtk_label_clear_layout (label);
3081       gtk_widget_queue_resize (GTK_WIDGET (label));
3082       g_object_notify (G_OBJECT (label), "wrap");
3083     }
3084 }
3085
3086 /**
3087  * gtk_label_get_line_wrap:
3088  * @label: a #GtkLabel
3089  *
3090  * Returns whether lines in the label are automatically wrapped.
3091  * See gtk_label_set_line_wrap().
3092  *
3093  * Return value: %TRUE if the lines of the label are automatically wrapped.
3094  */
3095 gboolean
3096 gtk_label_get_line_wrap (GtkLabel *label)
3097 {
3098   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
3099
3100   return label->priv->wrap;
3101 }
3102
3103 /**
3104  * gtk_label_set_line_wrap_mode:
3105  * @label: a #GtkLabel
3106  * @wrap_mode: the line wrapping mode
3107  *
3108  * If line wrapping is on (see gtk_label_set_line_wrap()) this controls how
3109  * the line wrapping is done. The default is %PANGO_WRAP_WORD which means
3110  * wrap on word boundaries.
3111  *
3112  * Since: 2.10
3113  **/
3114 void
3115 gtk_label_set_line_wrap_mode (GtkLabel *label,
3116                               PangoWrapMode wrap_mode)
3117 {
3118   GtkLabelPrivate *priv;
3119
3120   g_return_if_fail (GTK_IS_LABEL (label));
3121
3122   priv = label->priv;
3123
3124   if (priv->wrap_mode != wrap_mode)
3125     {
3126       priv->wrap_mode = wrap_mode;
3127       g_object_notify (G_OBJECT (label), "wrap-mode");
3128
3129       gtk_widget_queue_resize (GTK_WIDGET (label));
3130     }
3131 }
3132
3133 /**
3134  * gtk_label_get_line_wrap_mode:
3135  * @label: a #GtkLabel
3136  *
3137  * Returns line wrap mode used by the label. See gtk_label_set_line_wrap_mode().
3138  *
3139  * Return value: %TRUE if the lines of the label are automatically wrapped.
3140  *
3141  * Since: 2.10
3142  */
3143 PangoWrapMode
3144 gtk_label_get_line_wrap_mode (GtkLabel *label)
3145 {
3146   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
3147
3148   return label->priv->wrap_mode;
3149 }
3150
3151 static void
3152 gtk_label_destroy (GtkWidget *widget)
3153 {
3154   GtkLabel *label = GTK_LABEL (widget);
3155
3156   gtk_label_set_mnemonic_widget (label, NULL);
3157
3158   GTK_WIDGET_CLASS (gtk_label_parent_class)->destroy (widget);
3159 }
3160
3161 static void
3162 gtk_label_finalize (GObject *object)
3163 {
3164   GtkLabel *label = GTK_LABEL (object);
3165   GtkLabelPrivate *priv = label->priv;
3166
3167   g_free (priv->label);
3168   g_free (priv->text);
3169
3170   if (priv->layout)
3171     g_object_unref (priv->layout);
3172
3173   if (priv->attrs)
3174     pango_attr_list_unref (priv->attrs);
3175
3176   if (priv->effective_attrs)
3177     pango_attr_list_unref (priv->effective_attrs);
3178
3179   gtk_label_clear_links (label);
3180   g_free (priv->select_info);
3181
3182   G_OBJECT_CLASS (gtk_label_parent_class)->finalize (object);
3183 }
3184
3185 static void
3186 gtk_label_clear_layout (GtkLabel *label)
3187 {
3188   GtkLabelPrivate *priv = label->priv;
3189
3190   if (priv->layout)
3191     {
3192       g_object_unref (priv->layout);
3193       priv->layout = NULL;
3194
3195       //gtk_label_clear_links (label);
3196     }
3197 }
3198
3199 static PangoFontMetrics *
3200 get_font_metrics (PangoContext *context, GtkWidget *widget)
3201 {
3202   GtkStyleContext *style_context;
3203   PangoFontDescription *font;
3204   PangoFontMetrics *retval;
3205
3206   style_context = gtk_widget_get_style_context (widget);
3207   gtk_style_context_get (style_context, 0, "font", &font, NULL);
3208
3209   retval = pango_context_get_metrics (context,
3210                                       font,
3211                                       pango_context_get_language (context));
3212
3213   if (font != NULL)
3214     pango_font_description_free (font);
3215
3216   return retval;
3217 }
3218
3219 /**
3220  * gtk_label_get_measuring_layout:
3221  * @label: the label
3222  * @existing_layout: %NULL or an existing layout already in use.
3223  * @width: the width to measure with in pango units, or -1 for infinite
3224  * @height: the height to measure with in pango units, or -1 for infinite
3225  *
3226  * Gets a layout that can be used for measuring sizes. The returned
3227  * layout will be identical to the label's layout except for the
3228  * layout's width, which will be set to @width. Do not modify the returned
3229  * layout.
3230  *
3231  * Returns: a new reference to a pango layout
3232  **/
3233 static PangoLayout *
3234 gtk_label_get_measuring_layout (GtkLabel *   label,
3235                                 PangoLayout *existing_layout,
3236                                 int          width,
3237                                 int          height)
3238 {
3239   GtkLabelPrivate *priv = label->priv;
3240   PangoRectangle rect;
3241   PangoLayout *copy;
3242
3243   if (existing_layout != NULL)
3244     {
3245       if (existing_layout != priv->layout)
3246         {
3247           pango_layout_set_width (existing_layout, width);
3248           pango_layout_set_height (existing_layout, height);
3249           return existing_layout;
3250         }
3251
3252       g_object_unref (existing_layout);
3253     }
3254
3255   gtk_label_ensure_layout (label);
3256
3257   if (pango_layout_get_width (priv->layout) == width &&
3258       pango_layout_get_height (priv->layout) == height)
3259     {
3260       g_object_ref (priv->layout);
3261       return priv->layout;
3262     }
3263
3264   /* We can use the label's own layout if we're not allocated a size yet,
3265    * because we don't need it to be properly setup at that point.
3266    * This way we can make use of caching upon the label's creation.
3267    */
3268   if (gtk_widget_get_allocated_width (GTK_WIDGET (label)) <= 1)
3269     {
3270       g_object_ref (priv->layout);
3271       pango_layout_set_width (priv->layout, width);
3272       pango_layout_set_height (priv->layout, height);
3273       return priv->layout;
3274     }
3275
3276   /* oftentimes we want to measure a width that is far wider than the current width,
3277    * even though the layout would not change if we made it wider. In that case, we
3278    * can just return the current layout, because for measuring purposes, it will be
3279    * identical.
3280    */
3281   pango_layout_get_extents (priv->layout, NULL, &rect);
3282   if ((width == -1 || rect.width <= width) &&
3283       (height == -1 || rect.height <= height) &&
3284       !pango_layout_is_wrapped (priv->layout) &&
3285       !pango_layout_is_ellipsized (priv->layout))
3286     {
3287       g_object_ref (priv->layout);
3288       return priv->layout;
3289     }
3290
3291   copy = pango_layout_copy (priv->layout);
3292   pango_layout_set_width (copy, width);
3293   pango_layout_set_height (copy, height);
3294   return copy;
3295 }
3296
3297 static void
3298 gtk_label_update_layout_width (GtkLabel *label)
3299 {
3300   GtkLabelPrivate *priv = label->priv;
3301   GtkWidget *widget = GTK_WIDGET (label);
3302
3303   g_assert (priv->layout);
3304
3305   if (priv->ellipsize || priv->wrap)
3306     {
3307       PangoRectangle logical;
3308       gint xpad, ypad;
3309       gint width, height;
3310
3311       gtk_misc_get_padding (GTK_MISC (label), &xpad, &ypad);
3312
3313       width = gtk_widget_get_allocated_width (GTK_WIDGET (label)) - xpad * 2;
3314       height = gtk_widget_get_allocated_height (GTK_WIDGET (label)) - ypad * 2;
3315
3316       if (priv->have_transform)
3317         {
3318           PangoContext *context = gtk_widget_get_pango_context (widget);
3319           const PangoMatrix *matrix = pango_context_get_matrix (context);
3320           const gdouble dx = matrix->xx; /* cos (M_PI * angle / 180) */
3321           const gdouble dy = matrix->xy; /* sin (M_PI * angle / 180) */
3322
3323           pango_layout_set_width (priv->layout, -1);
3324           pango_layout_set_height (priv->layout, -1);
3325           pango_layout_get_pixel_extents (priv->layout, NULL, &logical);
3326
3327           if (fabs (dy) < 0.01)
3328             {
3329               if (logical.width > width)
3330                 pango_layout_set_width (priv->layout, width * PANGO_SCALE);
3331             }
3332           else if (fabs (dx) < 0.01)
3333             {
3334               if (logical.width > height)
3335                 pango_layout_set_width (priv->layout, height * PANGO_SCALE);
3336             }
3337           else
3338             {
3339               gdouble x0, y0, x1, y1, length;
3340               gboolean vertical;
3341               gint cy;
3342
3343               x0 = width / 2;
3344               y0 = dx ? x0 * dy / dx : G_MAXDOUBLE;
3345               vertical = fabs (y0) > height / 2;
3346
3347               if (vertical)
3348                 {
3349                   y0 = height/2;
3350                   x0 = dy ? y0 * dx / dy : G_MAXDOUBLE;
3351                 }
3352
3353               length = 2 * sqrt (x0 * x0 + y0 * y0);
3354               pango_layout_set_width (priv->layout, rint (length * PANGO_SCALE));
3355               pango_layout_get_pixel_size (priv->layout, NULL, &cy);
3356
3357               x1 = +dy * cy/2;
3358               y1 = -dx * cy/2;
3359
3360               if (vertical)
3361                 {
3362                   y0 = height/2 + y1 - y0;
3363                   x0 = -y0 * dx/dy;
3364                 }
3365               else
3366                 {
3367                   x0 = width/2 + x1 - x0;
3368                   y0 = -x0 * dy/dx;
3369                 }
3370
3371               length = length - sqrt (x0 * x0 + y0 * y0) * 2;
3372               pango_layout_set_width (priv->layout, rint (length * PANGO_SCALE));
3373             }
3374         }
3375       else
3376         {
3377           pango_layout_set_width (priv->layout, width * PANGO_SCALE);
3378           pango_layout_set_height (priv->layout, priv->ellipsize ? height * PANGO_SCALE : -1);
3379         }
3380     }
3381   else
3382     {
3383       pango_layout_set_width (priv->layout, -1);
3384       pango_layout_set_height (priv->layout, -1);
3385     }
3386 }
3387
3388 static void
3389 gtk_label_ensure_layout (GtkLabel *label)
3390 {
3391   GtkLabelPrivate *priv = label->priv;
3392   GtkWidget *widget;
3393   gboolean rtl;
3394
3395   widget = GTK_WIDGET (label);
3396
3397   rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
3398
3399   if (!priv->layout)
3400     {
3401       PangoAlignment align = PANGO_ALIGN_LEFT; /* Quiet gcc */
3402       gdouble angle = gtk_label_get_angle (label);
3403
3404       if (angle != 0.0 && !priv->select_info)
3405         {
3406           PangoMatrix matrix = PANGO_MATRIX_INIT;
3407
3408           /* We rotate the standard singleton PangoContext for the widget,
3409            * depending on the fact that it's meant pretty much exclusively
3410            * for our use.
3411            */
3412           pango_matrix_rotate (&matrix, angle);
3413
3414           pango_context_set_matrix (gtk_widget_get_pango_context (widget), &matrix);
3415
3416           priv->have_transform = TRUE;
3417         }
3418       else
3419         {
3420           if (priv->have_transform)
3421             pango_context_set_matrix (gtk_widget_get_pango_context (widget), NULL);
3422
3423           priv->have_transform = FALSE;
3424         }
3425
3426       priv->layout = gtk_widget_create_pango_layout (widget, priv->text);
3427
3428       if (priv->effective_attrs)
3429         pango_layout_set_attributes (priv->layout, priv->effective_attrs);
3430
3431       gtk_label_rescan_links (label);
3432
3433       switch (priv->jtype)
3434         {
3435         case GTK_JUSTIFY_LEFT:
3436           align = rtl ? PANGO_ALIGN_RIGHT : PANGO_ALIGN_LEFT;
3437           break;
3438         case GTK_JUSTIFY_RIGHT:
3439           align = rtl ? PANGO_ALIGN_LEFT : PANGO_ALIGN_RIGHT;
3440           break;
3441         case GTK_JUSTIFY_CENTER:
3442           align = PANGO_ALIGN_CENTER;
3443           break;
3444         case GTK_JUSTIFY_FILL:
3445           align = rtl ? PANGO_ALIGN_RIGHT : PANGO_ALIGN_LEFT;
3446           pango_layout_set_justify (priv->layout, TRUE);
3447           break;
3448         default:
3449           g_assert_not_reached();
3450         }
3451
3452       pango_layout_set_alignment (priv->layout, align);
3453       pango_layout_set_ellipsize (priv->layout, priv->ellipsize);
3454       pango_layout_set_wrap (priv->layout, priv->wrap_mode);
3455       pango_layout_set_single_paragraph_mode (priv->layout, priv->single_line_mode);
3456
3457       gtk_label_update_layout_width (label);
3458     }
3459 }
3460
3461 static gint
3462 get_single_line_height (GtkWidget   *widget,
3463                         PangoLayout *layout)
3464 {
3465   PangoContext *context;
3466   PangoFontMetrics *metrics;
3467   gint ascent, descent;
3468
3469   context = pango_layout_get_context (layout);
3470   metrics = get_font_metrics (context, widget);
3471   ascent = pango_font_metrics_get_ascent (metrics);
3472   descent = pango_font_metrics_get_descent (metrics);
3473   pango_font_metrics_unref (metrics);
3474
3475   return ascent + descent;
3476 }
3477
3478 static GtkSizeRequestMode
3479 gtk_label_get_request_mode (GtkWidget *widget)
3480 {
3481   GtkLabel *label = GTK_LABEL (widget);
3482   gdouble   angle = gtk_label_get_angle (label);
3483
3484   if (label->priv->wrap)
3485     return (angle == 90 || angle == 270) ?
3486       GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT :
3487       GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH;
3488
3489     return GTK_SIZE_REQUEST_CONSTANT_SIZE;
3490 }
3491
3492 static void
3493 get_size_for_allocation (GtkLabel        *label,
3494                          GtkOrientation   orientation,
3495                          gint             allocation,
3496                          gint            *minimum_size,
3497                          gint            *natural_size)
3498 {
3499   GtkLabelPrivate *priv = label->priv;
3500   PangoLayout *layout;
3501   gint text_height;
3502
3503   layout = gtk_label_get_measuring_layout (label, NULL, allocation * PANGO_SCALE, -1);
3504
3505   pango_layout_get_pixel_size (layout, NULL, &text_height);
3506
3507   if (minimum_size)
3508     *minimum_size = text_height;
3509
3510   if (natural_size)
3511     {
3512       if (priv->ellipsize && priv->wrap)
3513         {
3514           layout = gtk_label_get_measuring_layout (label, layout, allocation * PANGO_SCALE, G_MAXINT);
3515           pango_layout_get_pixel_size (layout, NULL, &text_height);
3516         }
3517
3518       *natural_size = text_height;
3519     }
3520
3521   g_object_unref (layout);
3522 }
3523
3524 static gint
3525 get_char_pixels (GtkWidget   *label,
3526                  PangoLayout *layout)
3527 {
3528   PangoContext *context;
3529   PangoFontMetrics *metrics;
3530   gint char_width, digit_width;
3531
3532   context = pango_layout_get_context (layout);
3533   metrics = get_font_metrics (context, GTK_WIDGET (label));
3534   char_width = pango_font_metrics_get_approximate_char_width (metrics);
3535   digit_width = pango_font_metrics_get_approximate_digit_width (metrics);
3536   pango_font_metrics_unref (metrics);
3537
3538   return MAX (char_width, digit_width);;
3539 }
3540
3541 static void
3542 gtk_label_get_preferred_layout_size (GtkLabel *label,
3543                                      PangoRectangle *required,
3544                                      PangoRectangle *natural)
3545 {
3546   GtkLabelPrivate *priv = label->priv;
3547   PangoLayout *layout;
3548
3549   /* "width-chars" Hard-coded minimum width:
3550    *    - minimum size should be MAX (width-chars, strlen ("..."));
3551    *    - natural size should be MAX (width-chars, strlen (priv->text));
3552    *
3553    * "max-width-chars" User specified maximum size requisition
3554    *    - minimum size should be MAX (width-chars, 0)
3555    *    - natural size should be MIN (max-width-chars, strlen (priv->text))
3556    *
3557    *    For ellipsizing labels; if max-width-chars is specified: either it is used as
3558    *    a minimum size or the label text as a minimum size (natural size still overflows).
3559    *
3560    *    For wrapping labels; A reasonable minimum size is useful to naturally layout
3561    *    interfaces automatically. In this case if no "width-chars" is specified, the minimum
3562    *    width will default to the wrap guess that gtk_label_ensure_layout() does.
3563    */
3564
3565   /* Start off with the pixel extents of an as-wide-as-possible layout */
3566   layout = gtk_label_get_measuring_layout (label, NULL, -1, -1);
3567
3568   pango_layout_get_extents (layout, NULL, natural);
3569   natural->x = natural->y = 0;
3570
3571   if (priv->wrap)
3572     natural->height = get_single_line_height (GTK_WIDGET (label), layout);
3573
3574   if (priv->ellipsize || priv->wrap)
3575     {
3576       /* a layout with width 0 will be as small as humanly possible */
3577       layout = gtk_label_get_measuring_layout (label, layout, 0, -1);
3578
3579       pango_layout_get_extents (layout, NULL, required);
3580
3581       /* can happen when Pango decides to ellipsize text */
3582       if (required->width > natural->width)
3583         required->width = natural->width;
3584
3585       required->x = required->y = 0;
3586       required->height = natural->height;
3587     }
3588   else
3589     {
3590       *required = *natural;
3591     }
3592
3593   if (priv->width_chars > -1 || priv->max_width_chars > -1)
3594     {
3595       gint char_pixels;
3596
3597       char_pixels = get_char_pixels (GTK_WIDGET (label), layout);
3598
3599       if (priv->width_chars > -1)
3600         required->width = MAX (required->width, char_pixels * priv->width_chars);
3601
3602       if (priv->max_width_chars > -1)
3603         natural->width = MIN (natural->width, priv->max_width_chars * char_pixels);
3604       natural->width = MAX (natural->width, required->width);
3605     }
3606
3607   g_object_unref (layout);
3608 }
3609
3610 static void
3611 gtk_label_get_preferred_size (GtkWidget      *widget,
3612                               GtkOrientation  orientation,
3613                               gint           *minimum_size,
3614                               gint           *natural_size)
3615 {
3616   GtkLabel      *label = GTK_LABEL (widget);
3617   GtkLabelPrivate  *priv = label->priv;
3618   PangoRectangle required_rect;
3619   PangoRectangle natural_rect;
3620   gint           xpad, ypad;
3621
3622   gtk_label_get_preferred_layout_size (label, &required_rect, &natural_rect);
3623
3624   /* Now that we have minimum and natural sizes in pango extents, apply a possible transform */
3625   if (priv->have_transform)
3626     {
3627       PangoLayout *copy;
3628       PangoContext *context;
3629       const PangoMatrix *matrix;
3630
3631       copy = pango_layout_copy (priv->layout);
3632       context = pango_layout_get_context (copy);
3633       matrix = pango_context_get_matrix (context);
3634
3635       pango_layout_set_width (copy, -1);
3636       pango_layout_set_ellipsize (copy, PANGO_ELLIPSIZE_NONE);
3637
3638       pango_layout_get_extents (copy, NULL, &natural_rect);
3639       g_object_unref (copy);
3640
3641       pango_matrix_transform_rectangle (matrix, &required_rect);
3642       pango_matrix_transform_rectangle (matrix, &natural_rect);
3643
3644       /* Bump the natural size in case of ellipsize to ensure pango has
3645        * enough space in the angles (note, we could alternatively set the
3646        * layout to not ellipsize when we know we have been allocated our
3647        * full natural size, or it may be that pango needs a fix here).
3648        */
3649       if (priv->ellipsize && priv->angle != 0 && priv->angle != 90 &&
3650           priv->angle != 180 && priv->angle != 270 && priv->angle != 360)
3651         {
3652           /* For some reason we only need this at about 110 degrees, and only
3653            * when gaining in height
3654            */
3655           natural_rect.height += ROTATION_ELLIPSIZE_PADDING * 2 * PANGO_SCALE;
3656           natural_rect.width  += ROTATION_ELLIPSIZE_PADDING * 2 * PANGO_SCALE;
3657         }
3658     }
3659
3660   required_rect.width  = PANGO_PIXELS_CEIL (required_rect.width);
3661   required_rect.height = PANGO_PIXELS_CEIL (required_rect.height);
3662
3663   natural_rect.width  = PANGO_PIXELS_CEIL (natural_rect.width);
3664   natural_rect.height = PANGO_PIXELS_CEIL (natural_rect.height);
3665
3666   gtk_misc_get_padding (GTK_MISC (label), &xpad, &ypad);
3667
3668   if (orientation == GTK_ORIENTATION_HORIZONTAL)
3669     {
3670       /* Note, we cant use get_size_for_allocation() when rotating
3671        * ellipsized labels.
3672        */
3673       if (!(priv->ellipsize && priv->have_transform) &&
3674           (priv->angle == 90 || priv->angle == 270))
3675         {
3676           /* Doing a h4w request on a rotated label here, return the
3677            * required width for the minimum height.
3678            */
3679           get_size_for_allocation (label,
3680                                    GTK_ORIENTATION_VERTICAL,
3681                                    required_rect.height,
3682                                    minimum_size, natural_size);
3683
3684         }
3685       else
3686         {
3687           /* Normal desired width */
3688           *minimum_size = required_rect.width;
3689           *natural_size = natural_rect.width;
3690         }
3691
3692       *minimum_size += xpad * 2;
3693       *natural_size += xpad * 2;
3694     }
3695   else /* GTK_ORIENTATION_VERTICAL */
3696     {
3697       /* Note, we cant use get_size_for_allocation() when rotating
3698        * ellipsized labels.
3699        */
3700       if (!(priv->ellipsize && priv->have_transform) &&
3701           (priv->angle == 0 || priv->angle == 180 || priv->angle == 360))
3702         {
3703           /* Doing a w4h request on a label here, return the required
3704            * height for the minimum width.
3705            */
3706           get_size_for_allocation (label,
3707                                    GTK_ORIENTATION_HORIZONTAL,
3708                                    required_rect.width,
3709                                    minimum_size, natural_size);
3710         }
3711       else
3712         {
3713           /* A vertically rotated label does w4h, so return the base
3714            * desired height (text length)
3715            */
3716           *minimum_size = required_rect.height;
3717           *natural_size = natural_rect.height;
3718         }
3719
3720       *minimum_size += ypad * 2;
3721       *natural_size += ypad * 2;
3722     }
3723 }
3724
3725
3726 static void
3727 gtk_label_get_preferred_width (GtkWidget *widget,
3728                                gint      *minimum_size,
3729                                gint      *natural_size)
3730 {
3731   gtk_label_get_preferred_size (widget, GTK_ORIENTATION_HORIZONTAL, minimum_size, natural_size);
3732 }
3733
3734 static void
3735 gtk_label_get_preferred_height (GtkWidget *widget,
3736                                 gint      *minimum_size,
3737                                 gint      *natural_size)
3738 {
3739   gtk_label_get_preferred_size (widget, GTK_ORIENTATION_VERTICAL, minimum_size, natural_size);
3740 }
3741
3742 static void
3743 gtk_label_get_preferred_width_for_height (GtkWidget *widget,
3744                                           gint       height,
3745                                           gint      *minimum_width,
3746                                           gint      *natural_width)
3747 {
3748   GtkLabel *label = GTK_LABEL (widget);
3749   GtkLabelPrivate *priv = label->priv;
3750
3751   if (priv->wrap && (priv->angle == 90 || priv->angle == 270))
3752     {
3753       gint xpad, ypad;
3754
3755       gtk_misc_get_padding (GTK_MISC (label), &xpad, &ypad);
3756
3757       if (priv->wrap)
3758         gtk_label_clear_layout (label);
3759
3760       get_size_for_allocation (label, GTK_ORIENTATION_VERTICAL,
3761                                MAX (1, height - (ypad * 2)),
3762                                minimum_width, natural_width);
3763
3764       if (minimum_width)
3765         *minimum_width += xpad * 2;
3766
3767       if (natural_width)
3768         *natural_width += xpad * 2;
3769     }
3770   else
3771     GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, minimum_width, natural_width);
3772 }
3773
3774 static void
3775 gtk_label_get_preferred_height_for_width (GtkWidget *widget,
3776                                           gint       width,
3777                                           gint      *minimum_height,
3778                                           gint      *natural_height)
3779 {
3780   GtkLabel *label = GTK_LABEL (widget);
3781   GtkLabelPrivate *priv = label->priv;
3782
3783   if (priv->wrap && (priv->angle == 0 || priv->angle == 180 || priv->angle == 360))
3784     {
3785       gint xpad, ypad;
3786
3787       gtk_misc_get_padding (GTK_MISC (label), &xpad, &ypad);
3788
3789       if (priv->wrap)
3790         gtk_label_clear_layout (label);
3791
3792       get_size_for_allocation (label, GTK_ORIENTATION_HORIZONTAL,
3793                                MAX (1, width - xpad * 2),
3794                                minimum_height, natural_height);
3795
3796       if (minimum_height)
3797         *minimum_height += ypad * 2;
3798
3799       if (natural_height)
3800         *natural_height += ypad * 2;
3801     }
3802   else
3803     GTK_WIDGET_GET_CLASS (widget)->get_preferred_height (widget, minimum_height, natural_height);
3804 }
3805
3806 static void
3807 gtk_label_size_allocate (GtkWidget     *widget,
3808                          GtkAllocation *allocation)
3809 {
3810   GtkLabel *label = GTK_LABEL (widget);
3811   GtkLabelPrivate *priv = label->priv;
3812
3813   GTK_WIDGET_CLASS (gtk_label_parent_class)->size_allocate (widget, allocation);
3814
3815   if (priv->layout)
3816     gtk_label_update_layout_width (label);
3817
3818   if (priv->select_info && priv->select_info->window)
3819     {
3820       gdk_window_move_resize (priv->select_info->window,
3821                               allocation->x,
3822                               allocation->y,
3823                               allocation->width,
3824                               allocation->height);
3825     }
3826 }
3827
3828 static void
3829 gtk_label_update_cursor (GtkLabel *label)
3830 {
3831   GtkLabelPrivate *priv = label->priv;
3832   GtkWidget *widget;
3833
3834   if (!priv->select_info)
3835     return;
3836
3837   widget = GTK_WIDGET (label);
3838
3839   if (gtk_widget_get_realized (widget))
3840     {
3841       GdkDisplay *display;
3842       GdkCursor *cursor;
3843
3844       if (gtk_widget_is_sensitive (widget))
3845         {
3846           display = gtk_widget_get_display (widget);
3847
3848           if (priv->select_info->active_link)
3849             cursor = gdk_cursor_new_for_display (display, GDK_HAND2);
3850           else if (priv->select_info->selectable)
3851             cursor = gdk_cursor_new_for_display (display, GDK_XTERM);
3852           else
3853             cursor = NULL;
3854         }
3855       else
3856         cursor = NULL;
3857
3858       gdk_window_set_cursor (priv->select_info->window, cursor);
3859
3860       if (cursor)
3861         g_object_unref (cursor);
3862     }
3863 }
3864
3865 static void
3866 gtk_label_state_changed (GtkWidget   *widget,
3867                          GtkStateType prev_state)
3868 {
3869   GtkLabel *label = GTK_LABEL (widget);
3870   GtkLabelPrivate *priv = label->priv;
3871
3872   if (priv->select_info)
3873     {
3874       if (!gtk_widget_is_sensitive (widget))
3875         gtk_label_select_region (label, 0, 0);
3876
3877       gtk_label_update_cursor (label);
3878     }
3879
3880   if (GTK_WIDGET_CLASS (gtk_label_parent_class)->state_changed)
3881     GTK_WIDGET_CLASS (gtk_label_parent_class)->state_changed (widget, prev_state);
3882 }
3883
3884 static void
3885 gtk_label_style_updated (GtkWidget *widget)
3886 {
3887   GtkLabel *label = GTK_LABEL (widget);
3888
3889   GTK_WIDGET_CLASS (gtk_label_parent_class)->style_updated (widget);
3890
3891   /* We have to clear the layout, fonts etc. may have changed */
3892   gtk_label_clear_layout (label);
3893 }
3894
3895 static void
3896 gtk_label_direction_changed (GtkWidget        *widget,
3897                              GtkTextDirection previous_dir)
3898 {
3899   GtkLabel *label = GTK_LABEL (widget);
3900   GtkLabelPrivate *priv = label->priv;
3901
3902   if (priv->layout)
3903     pango_layout_context_changed (priv->layout);
3904
3905   GTK_WIDGET_CLASS (gtk_label_parent_class)->direction_changed (widget, previous_dir);
3906 }
3907
3908 static void
3909 get_layout_location (GtkLabel  *label,
3910                      gint      *xp,
3911                      gint      *yp)
3912 {
3913   GtkAllocation allocation;
3914   GtkMisc *misc;
3915   GtkWidget *widget;
3916   GtkLabelPrivate *priv;
3917   gint req_width, x, y;
3918   gint req_height;
3919   gint xpad, ypad;
3920   gfloat xalign, yalign;
3921   PangoRectangle logical;
3922
3923   misc   = GTK_MISC (label);
3924   widget = GTK_WIDGET (label);
3925   priv   = label->priv;
3926
3927   gtk_misc_get_alignment (misc, &xalign, &yalign);
3928   gtk_misc_get_padding (misc, &xpad, &ypad);
3929
3930   if (gtk_widget_get_direction (widget) != GTK_TEXT_DIR_LTR)
3931     xalign = 1.0 - xalign;
3932
3933   pango_layout_get_extents (priv->layout, NULL, &logical);
3934
3935   if (priv->have_transform)
3936     {
3937       PangoContext *context = gtk_widget_get_pango_context (widget);
3938       const PangoMatrix *matrix = pango_context_get_matrix (context);
3939       pango_matrix_transform_rectangle (matrix, &logical);
3940     }
3941
3942   pango_extents_to_pixels (&logical, NULL);
3943
3944   req_width  = logical.width;
3945   req_height = logical.height;
3946
3947   req_width  += 2 * xpad;
3948   req_height += 2 * ypad;
3949
3950   gtk_widget_get_allocation (widget, &allocation);
3951
3952   x = floor (allocation.x + xpad + xalign * (allocation.width - req_width) - logical.x);
3953
3954
3955   /* bgo#315462 - For single-line labels, *do* align the requisition with
3956    * respect to the allocation, even if we are under-allocated.  For multi-line
3957    * labels, always show the top of the text when they are under-allocated.  The
3958    * rationale is this:
3959    *
3960    * - Single-line labels appear in GtkButtons, and it is very easy to get them
3961    *   to be smaller than their requisition.  The button may clip the label, but
3962    *   the label will still be able to show most of itself and the focus
3963    *   rectangle.  Also, it is fairly easy to read a single line of clipped text.
3964    *
3965    * - Multi-line labels should not be clipped to showing "something in the
3966    *   middle".  You want to read the first line, at least, to get some context.
3967    */
3968   if (pango_layout_get_line_count (priv->layout) == 1)
3969     y = floor (allocation.y + ypad + (allocation.height - req_height) * yalign) - logical.y;
3970   else
3971     y = floor (allocation.y + ypad + MAX ((allocation.height - req_height) * yalign, 0)) - logical.y;
3972
3973   if (xp)
3974     *xp = x;
3975
3976   if (yp)
3977     *yp = y;
3978 }
3979
3980 static void
3981 draw_insertion_cursor (GtkLabel      *label,
3982                        cairo_t       *cr,
3983                        GdkRectangle  *cursor_location,
3984                        gboolean       is_primary,
3985                        PangoDirection direction,
3986                        gboolean       draw_arrow)
3987 {
3988   GtkWidget *widget = GTK_WIDGET (label);
3989   GtkTextDirection text_dir;
3990
3991   if (direction == PANGO_DIRECTION_LTR)
3992     text_dir = GTK_TEXT_DIR_LTR;
3993   else
3994     text_dir = GTK_TEXT_DIR_RTL;
3995
3996   gtk_draw_insertion_cursor (widget, cr, cursor_location,
3997                              is_primary, text_dir, draw_arrow);
3998 }
3999
4000 static PangoDirection
4001 get_cursor_direction (GtkLabel *label)
4002 {
4003   GtkLabelPrivate *priv = label->priv;
4004   GSList *l;
4005
4006   g_assert (priv->select_info);
4007
4008   gtk_label_ensure_layout (label);
4009
4010   for (l = pango_layout_get_lines_readonly (priv->layout); l; l = l->next)
4011     {
4012       PangoLayoutLine *line = l->data;
4013
4014       /* If priv->select_info->selection_end is at the very end of
4015        * the line, we don't know if the cursor is on this line or
4016        * the next without looking ahead at the next line. (End
4017        * of paragraph is different from line break.) But it's
4018        * definitely in this paragraph, which is good enough
4019        * to figure out the resolved direction.
4020        */
4021        if (line->start_index + line->length >= priv->select_info->selection_end)
4022         return line->resolved_dir;
4023     }
4024
4025   return PANGO_DIRECTION_LTR;
4026 }
4027
4028 static void
4029 gtk_label_draw_cursor (GtkLabel  *label, cairo_t *cr, gint xoffset, gint yoffset)
4030 {
4031   GtkLabelPrivate *priv = label->priv;
4032   GtkWidget *widget;
4033
4034   if (priv->select_info == NULL)
4035     return;
4036
4037   widget = GTK_WIDGET (label);
4038
4039   if (gtk_widget_is_drawable (widget))
4040     {
4041       PangoDirection keymap_direction;
4042       PangoDirection cursor_direction;
4043       PangoRectangle strong_pos, weak_pos;
4044       gboolean split_cursor;
4045       PangoRectangle *cursor1 = NULL;
4046       PangoRectangle *cursor2 = NULL;
4047       GdkRectangle cursor_location;
4048       PangoDirection dir1 = PANGO_DIRECTION_NEUTRAL;
4049       PangoDirection dir2 = PANGO_DIRECTION_NEUTRAL;
4050
4051       keymap_direction = gdk_keymap_get_direction (gdk_keymap_get_for_display (gtk_widget_get_display (widget)));
4052       cursor_direction = get_cursor_direction (label);
4053
4054       gtk_label_ensure_layout (label);
4055
4056       pango_layout_get_cursor_pos (priv->layout, priv->select_info->selection_end,
4057                                    &strong_pos, &weak_pos);
4058
4059       g_object_get (gtk_widget_get_settings (widget),
4060                     "gtk-split-cursor", &split_cursor,
4061                     NULL);
4062
4063       dir1 = cursor_direction;
4064
4065       if (split_cursor)
4066         {
4067           cursor1 = &strong_pos;
4068
4069           if (strong_pos.x != weak_pos.x ||
4070               strong_pos.y != weak_pos.y)
4071             {
4072               dir2 = (cursor_direction == PANGO_DIRECTION_LTR) ? PANGO_DIRECTION_RTL : PANGO_DIRECTION_LTR;
4073               cursor2 = &weak_pos;
4074             }
4075         }
4076       else
4077         {
4078           if (keymap_direction == cursor_direction)
4079             cursor1 = &strong_pos;
4080           else
4081             cursor1 = &weak_pos;
4082         }
4083
4084       cursor_location.x = xoffset + PANGO_PIXELS (cursor1->x);
4085       cursor_location.y = yoffset + PANGO_PIXELS (cursor1->y);
4086       cursor_location.width = 0;
4087       cursor_location.height = PANGO_PIXELS (cursor1->height);
4088
4089       draw_insertion_cursor (label, cr,
4090                              &cursor_location, TRUE, dir1,
4091                              dir2 != PANGO_DIRECTION_NEUTRAL);
4092
4093       if (dir2 != PANGO_DIRECTION_NEUTRAL)
4094         {
4095           cursor_location.x = xoffset + PANGO_PIXELS (cursor2->x);
4096           cursor_location.y = yoffset + PANGO_PIXELS (cursor2->y);
4097           cursor_location.width = 0;
4098           cursor_location.height = PANGO_PIXELS (cursor2->height);
4099
4100           draw_insertion_cursor (label, cr,
4101                                  &cursor_location, FALSE, dir2,
4102                                  TRUE);
4103         }
4104     }
4105 }
4106
4107 static GtkLabelLink *
4108 gtk_label_get_focus_link (GtkLabel *label)
4109 {
4110   GtkLabelPrivate *priv = label->priv;
4111   GtkLabelSelectionInfo *info = priv->select_info;
4112   GList *l;
4113
4114   if (!info)
4115     return NULL;
4116
4117   if (info->selection_anchor != info->selection_end)
4118     return NULL;
4119
4120   for (l = info->links; l; l = l->next)
4121     {
4122       GtkLabelLink *link = l->data;
4123       if (link->start <= info->selection_anchor &&
4124           info->selection_anchor <= link->end)
4125         return link;
4126     }
4127
4128   return NULL;
4129 }
4130
4131 static gint
4132 gtk_label_draw (GtkWidget *widget,
4133                 cairo_t   *cr)
4134 {
4135   GtkLabel *label = GTK_LABEL (widget);
4136   GtkLabelPrivate *priv = label->priv;
4137   GtkLabelSelectionInfo *info = priv->select_info;
4138   GtkAllocation allocation;
4139   GtkStyleContext *context;
4140   GtkStateFlags state;
4141   gint x, y;
4142
4143   gtk_label_ensure_layout (label);
4144
4145   if (priv->text && (*priv->text != '\0'))
4146     {
4147       GdkRGBA bg_color, fg_color;
4148
4149       get_layout_location (label, &x, &y);
4150
4151       context = gtk_widget_get_style_context (widget);
4152       gtk_widget_get_allocation (widget, &allocation);
4153
4154       cairo_translate (cr, -allocation.x, -allocation.y);
4155
4156       state = gtk_widget_get_state_flags (widget);
4157       gtk_style_context_set_state (context, state);
4158
4159       gtk_render_layout (context, cr,
4160                          x, y,
4161                          priv->layout);
4162
4163       if (info &&
4164           (info->selection_anchor != info->selection_end))
4165         {
4166           gint range[2];
4167           cairo_region_t *clip;
4168
4169           range[0] = info->selection_anchor;
4170           range[1] = info->selection_end;
4171
4172           if (range[0] > range[1])
4173             {
4174               gint tmp = range[0];
4175               range[0] = range[1];
4176               range[1] = tmp;
4177             }
4178
4179           clip = gdk_pango_layout_get_clip_region (priv->layout,
4180                                                    x, y,
4181                                                    range,
4182                                                    1);
4183
4184          /* FIXME should use gtk_paint, but it can't use a clip region */
4185           cairo_save (cr);
4186
4187           gdk_cairo_region (cr, clip);
4188           cairo_clip (cr);
4189
4190           state = GTK_STATE_FLAG_SELECTED;
4191
4192           if (gtk_widget_has_focus (widget))
4193             state |= GTK_STATE_FLAG_FOCUSED;
4194
4195           gtk_style_context_get_color (context, state, &fg_color);
4196           gtk_style_context_get_background_color (context, state, &bg_color);
4197
4198           gdk_cairo_set_source_rgba (cr, &bg_color);
4199           cairo_paint (cr);
4200
4201           gdk_cairo_set_source_rgba (cr, &fg_color);
4202           cairo_move_to (cr, x, y);
4203           _gtk_pango_fill_layout (cr, priv->layout);
4204
4205           cairo_restore (cr);
4206           cairo_region_destroy (clip);
4207         }
4208       else if (info)
4209         {
4210           GtkLabelLink *focus_link;
4211           GtkLabelLink *active_link;
4212           gint range[2];
4213           cairo_region_t *clip;
4214           GdkRectangle rect;
4215           GdkColor *text_color;
4216           GdkColor *link_color;
4217           GdkColor *visited_link_color;
4218
4219           if (info->selectable && gtk_widget_has_focus (widget))
4220             gtk_label_draw_cursor (label, cr, x, y);
4221
4222           focus_link = gtk_label_get_focus_link (label);
4223           active_link = info->active_link;
4224
4225
4226           if (active_link)
4227             {
4228               GdkRGBA bg_color;
4229
4230               range[0] = active_link->start;
4231               range[1] = active_link->end;
4232
4233               cairo_save (cr);
4234
4235               clip = gdk_pango_layout_get_clip_region (priv->layout,
4236                                                        x, y,
4237                                                        range,
4238                                                        1);
4239               gdk_cairo_region (cr, clip);
4240               cairo_clip (cr);
4241               cairo_region_destroy (clip);
4242
4243               gtk_label_get_link_colors (widget, &link_color, &visited_link_color);
4244               if (active_link->visited)
4245                 text_color = visited_link_color;
4246               else
4247                 text_color = link_color;
4248
4249               if (info->link_clicked)
4250                 state = GTK_STATE_FLAG_ACTIVE;
4251               else
4252                 state = GTK_STATE_FLAG_PRELIGHT;
4253
4254               gtk_style_context_get_background_color (context, state, &bg_color);
4255
4256               gdk_cairo_set_source_rgba (cr, &bg_color);
4257               cairo_paint (cr);
4258
4259               gdk_cairo_set_source_color (cr, text_color);
4260               cairo_move_to (cr, x, y);
4261               _gtk_pango_fill_layout (cr, priv->layout);
4262
4263               gdk_color_free (link_color);
4264               gdk_color_free (visited_link_color);
4265
4266               cairo_restore (cr);
4267             }
4268
4269           if (focus_link && gtk_widget_has_focus (widget))
4270             {
4271               range[0] = focus_link->start;
4272               range[1] = focus_link->end;
4273
4274               clip = gdk_pango_layout_get_clip_region (priv->layout,
4275                                                        x, y,
4276                                                        range,
4277                                                        1);
4278               cairo_region_get_extents (clip, &rect);
4279
4280               state = gtk_widget_get_state_flags (widget);
4281               gtk_style_context_set_state (context, state);
4282
4283               gtk_render_focus (context, cr,
4284                                 rect.x, rect.y,
4285                                 rect.width, rect.height);
4286
4287               cairo_region_destroy (clip);
4288             }
4289         }
4290     }
4291
4292   return FALSE;
4293 }
4294
4295 static gboolean
4296 separate_uline_pattern (const gchar  *str,
4297                         guint        *accel_key,
4298                         gchar       **new_str,
4299                         gchar       **pattern)
4300 {
4301   gboolean underscore;
4302   const gchar *src;
4303   gchar *dest;
4304   gchar *pattern_dest;
4305
4306   *accel_key = GDK_KEY_VoidSymbol;
4307   *new_str = g_new (gchar, strlen (str) + 1);
4308   *pattern = g_new (gchar, g_utf8_strlen (str, -1) + 1);
4309
4310   underscore = FALSE;
4311
4312   src = str;
4313   dest = *new_str;
4314   pattern_dest = *pattern;
4315
4316   while (*src)
4317     {
4318       gunichar c;
4319       const gchar *next_src;
4320
4321       c = g_utf8_get_char (src);
4322       if (c == (gunichar)-1)
4323         {
4324           g_warning ("Invalid input string");
4325           g_free (*new_str);
4326           g_free (*pattern);
4327
4328           return FALSE;
4329         }
4330       next_src = g_utf8_next_char (src);
4331
4332       if (underscore)
4333         {
4334           if (c == '_')
4335             *pattern_dest++ = ' ';
4336           else
4337             {
4338               *pattern_dest++ = '_';
4339               if (*accel_key == GDK_KEY_VoidSymbol)
4340                 *accel_key = gdk_keyval_to_lower (gdk_unicode_to_keyval (c));
4341             }
4342
4343           while (src < next_src)
4344             *dest++ = *src++;
4345
4346           underscore = FALSE;
4347         }
4348       else
4349         {
4350           if (c == '_')
4351             {
4352               underscore = TRUE;
4353               src = next_src;
4354             }
4355           else
4356             {
4357               while (src < next_src)
4358                 *dest++ = *src++;
4359
4360               *pattern_dest++ = ' ';
4361             }
4362         }
4363     }
4364
4365   *dest = 0;
4366   *pattern_dest = 0;
4367
4368   return TRUE;
4369 }
4370
4371 static void
4372 gtk_label_set_uline_text_internal (GtkLabel    *label,
4373                                    const gchar *str)
4374 {
4375   GtkLabelPrivate *priv = label->priv;
4376   guint accel_key = GDK_KEY_VoidSymbol;
4377   gchar *new_str;
4378   gchar *pattern;
4379
4380   g_return_if_fail (GTK_IS_LABEL (label));
4381   g_return_if_fail (str != NULL);
4382
4383   /* Split text into the base text and a separate pattern
4384    * of underscores.
4385    */
4386   if (!separate_uline_pattern (str, &accel_key, &new_str, &pattern))
4387     return;
4388
4389   gtk_label_set_text_internal (label, new_str);
4390   gtk_label_set_pattern_internal (label, pattern, TRUE);
4391   priv->mnemonic_keyval = accel_key;
4392
4393   g_free (pattern);
4394 }
4395
4396 /**
4397  * gtk_label_set_text_with_mnemonic:
4398  * @label: a #GtkLabel
4399  * @str: a string
4400  *
4401  * Sets the label's text from the string @str.
4402  * If characters in @str are preceded by an underscore, they are underlined
4403  * indicating that they represent a keyboard accelerator called a mnemonic.
4404  * The mnemonic key can be used to activate another widget, chosen
4405  * automatically, or explicitly using gtk_label_set_mnemonic_widget().
4406  **/
4407 void
4408 gtk_label_set_text_with_mnemonic (GtkLabel    *label,
4409                                   const gchar *str)
4410 {
4411   g_return_if_fail (GTK_IS_LABEL (label));
4412   g_return_if_fail (str != NULL);
4413
4414   g_object_freeze_notify (G_OBJECT (label));
4415
4416   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
4417   gtk_label_set_use_markup_internal (label, FALSE);
4418   gtk_label_set_use_underline_internal (label, TRUE);
4419
4420   gtk_label_recalculate (label);
4421
4422   g_object_thaw_notify (G_OBJECT (label));
4423 }
4424
4425 static void
4426 gtk_label_realize (GtkWidget *widget)
4427 {
4428   GtkLabel *label = GTK_LABEL (widget);
4429   GtkLabelPrivate *priv = label->priv;
4430
4431   GTK_WIDGET_CLASS (gtk_label_parent_class)->realize (widget);
4432
4433   if (priv->select_info)
4434     gtk_label_create_window (label);
4435 }
4436
4437 static void
4438 gtk_label_unrealize (GtkWidget *widget)
4439 {
4440   GtkLabel *label = GTK_LABEL (widget);
4441   GtkLabelPrivate *priv = label->priv;
4442
4443   if (priv->select_info)
4444     gtk_label_destroy_window (label);
4445
4446   GTK_WIDGET_CLASS (gtk_label_parent_class)->unrealize (widget);
4447 }
4448
4449 static void
4450 gtk_label_map (GtkWidget *widget)
4451 {
4452   GtkLabel *label = GTK_LABEL (widget);
4453   GtkLabelPrivate *priv = label->priv;
4454
4455   GTK_WIDGET_CLASS (gtk_label_parent_class)->map (widget);
4456
4457   if (priv->select_info)
4458     gdk_window_show (priv->select_info->window);
4459 }
4460
4461 static void
4462 gtk_label_unmap (GtkWidget *widget)
4463 {
4464   GtkLabel *label = GTK_LABEL (widget);
4465   GtkLabelPrivate *priv = label->priv;
4466
4467   if (priv->select_info)
4468     gdk_window_hide (priv->select_info->window);
4469
4470   GTK_WIDGET_CLASS (gtk_label_parent_class)->unmap (widget);
4471 }
4472
4473 static void
4474 window_to_layout_coords (GtkLabel *label,
4475                          gint     *x,
4476                          gint     *y)
4477 {
4478   GtkAllocation allocation;
4479   gint lx, ly;
4480   GtkWidget *widget;
4481
4482   widget = GTK_WIDGET (label);
4483
4484   /* get layout location in widget->window coords */
4485   get_layout_location (label, &lx, &ly);
4486
4487   gtk_widget_get_allocation (widget, &allocation);
4488
4489   if (x)
4490     {
4491       *x += allocation.x; /* go to widget->window */
4492       *x -= lx;                   /* go to layout */
4493     }
4494
4495   if (y)
4496     {
4497       *y += allocation.y; /* go to widget->window */
4498       *y -= ly;                   /* go to layout */
4499     }
4500 }
4501
4502 #if 0
4503 static void
4504 layout_to_window_coords (GtkLabel *label,
4505                          gint     *x,
4506                          gint     *y)
4507 {
4508   gint lx, ly;
4509   GtkWidget *widget;
4510
4511   widget = GTK_WIDGET (label);
4512
4513   /* get layout location in widget->window coords */
4514   get_layout_location (label, &lx, &ly);
4515
4516   if (x)
4517     {
4518       *x += lx;                   /* go to widget->window */
4519       *x -= widget->allocation.x; /* go to selection window */
4520     }
4521
4522   if (y)
4523     {
4524       *y += ly;                   /* go to widget->window */
4525       *y -= widget->allocation.y; /* go to selection window */
4526     }
4527 }
4528 #endif
4529
4530 static gboolean
4531 get_layout_index (GtkLabel *label,
4532                   gint      x,
4533                   gint      y,
4534                   gint     *index)
4535 {
4536   GtkLabelPrivate *priv = label->priv;
4537   gint trailing = 0;
4538   const gchar *cluster;
4539   const gchar *cluster_end;
4540   gboolean inside;
4541
4542   *index = 0;
4543
4544   gtk_label_ensure_layout (label);
4545
4546   window_to_layout_coords (label, &x, &y);
4547
4548   x *= PANGO_SCALE;
4549   y *= PANGO_SCALE;
4550
4551   inside = pango_layout_xy_to_index (priv->layout,
4552                                      x, y,
4553                                      index, &trailing);
4554
4555   cluster = priv->text + *index;
4556   cluster_end = cluster;
4557   while (trailing)
4558     {
4559       cluster_end = g_utf8_next_char (cluster_end);
4560       --trailing;
4561     }
4562
4563   *index += (cluster_end - cluster);
4564
4565   return inside;
4566 }
4567
4568 static void
4569 gtk_label_select_word (GtkLabel *label)
4570 {
4571   GtkLabelPrivate *priv = label->priv;
4572   gint min, max;
4573
4574   gint start_index = gtk_label_move_backward_word (label, priv->select_info->selection_end);
4575   gint end_index = gtk_label_move_forward_word (label, priv->select_info->selection_end);
4576
4577   min = MIN (priv->select_info->selection_anchor,
4578              priv->select_info->selection_end);
4579   max = MAX (priv->select_info->selection_anchor,
4580              priv->select_info->selection_end);
4581
4582   min = MIN (min, start_index);
4583   max = MAX (max, end_index);
4584
4585   gtk_label_select_region_index (label, min, max);
4586 }
4587
4588 static void
4589 gtk_label_grab_focus (GtkWidget *widget)
4590 {
4591   GtkLabel *label = GTK_LABEL (widget);
4592   GtkLabelPrivate *priv = label->priv;
4593   gboolean select_on_focus;
4594   GtkLabelLink *link;
4595
4596   if (priv->select_info == NULL)
4597     return;
4598
4599   GTK_WIDGET_CLASS (gtk_label_parent_class)->grab_focus (widget);
4600
4601   if (priv->select_info->selectable)
4602     {
4603       g_object_get (gtk_widget_get_settings (widget),
4604                     "gtk-label-select-on-focus",
4605                     &select_on_focus,
4606                     NULL);
4607
4608       if (select_on_focus && !priv->in_click)
4609         gtk_label_select_region (label, 0, -1);
4610     }
4611   else
4612     {
4613       if (priv->select_info->links && !priv->in_click)
4614         {
4615           link = priv->select_info->links->data;
4616           priv->select_info->selection_anchor = link->start;
4617           priv->select_info->selection_end = link->start;
4618         }
4619     }
4620 }
4621
4622 static gboolean
4623 gtk_label_focus (GtkWidget        *widget,
4624                  GtkDirectionType  direction)
4625 {
4626   GtkLabel *label = GTK_LABEL (widget);
4627   GtkLabelPrivate *priv = label->priv;
4628   GtkLabelSelectionInfo *info = priv->select_info;
4629   GtkLabelLink *focus_link;
4630   GList *l;
4631
4632   if (!gtk_widget_is_focus (widget))
4633     {
4634       gtk_widget_grab_focus (widget);
4635       if (info)
4636         {
4637           focus_link = gtk_label_get_focus_link (label);
4638           if (focus_link && direction == GTK_DIR_TAB_BACKWARD)
4639             {
4640               l = g_list_last (info->links);
4641               focus_link = l->data;
4642               info->selection_anchor = focus_link->start;
4643               info->selection_end = focus_link->start;
4644             }
4645         }
4646
4647       return TRUE;
4648     }
4649
4650   if (!info)
4651     return FALSE;
4652
4653   if (info->selectable)
4654     {
4655       gint index;
4656
4657       if (info->selection_anchor != info->selection_end)
4658         goto out;
4659
4660       index = info->selection_anchor;
4661
4662       if (direction == GTK_DIR_TAB_FORWARD)
4663         for (l = info->links; l; l = l->next)
4664           {
4665             GtkLabelLink *link = l->data;
4666
4667             if (link->start > index)
4668               {
4669                 gtk_label_select_region_index (label, link->start, link->start);
4670                 return TRUE;
4671               }
4672           }
4673       else if (direction == GTK_DIR_TAB_BACKWARD)
4674         for (l = g_list_last (info->links); l; l = l->prev)
4675           {
4676             GtkLabelLink *link = l->data;
4677
4678             if (link->end < index)
4679               {
4680                 gtk_label_select_region_index (label, link->start, link->start);
4681                 return TRUE;
4682               }
4683           }
4684
4685       goto out;
4686     }
4687   else
4688     {
4689       focus_link = gtk_label_get_focus_link (label);
4690       switch (direction)
4691         {
4692         case GTK_DIR_TAB_FORWARD:
4693           if (focus_link)
4694             {
4695               l = g_list_find (info->links, focus_link);
4696               l = l->next;
4697             }
4698           else
4699             l = info->links;
4700           break;
4701
4702         case GTK_DIR_TAB_BACKWARD:
4703           if (focus_link)
4704             {
4705               l = g_list_find (info->links, focus_link);
4706               l = l->prev;
4707             }
4708           else
4709             l = g_list_last (info->links);
4710           break;
4711
4712         default:
4713           goto out;
4714         }
4715
4716       if (l)
4717         {
4718           focus_link = l->data;
4719           info->selection_anchor = focus_link->start;
4720           info->selection_end = focus_link->start;
4721           gtk_widget_queue_draw (widget);
4722
4723           return TRUE;
4724         }
4725     }
4726
4727 out:
4728
4729   return FALSE;
4730 }
4731
4732 static gboolean
4733 gtk_label_button_press (GtkWidget      *widget,
4734                         GdkEventButton *event)
4735 {
4736   GtkLabel *label = GTK_LABEL (widget);
4737   GtkLabelPrivate *priv = label->priv;
4738   GtkLabelSelectionInfo *info = priv->select_info;
4739   gint index = 0;
4740   gint min, max;
4741
4742   if (info == NULL)
4743     return FALSE;
4744
4745   if (info->active_link)
4746     {
4747       if (event->button == 1)
4748         {
4749           info->link_clicked = 1;
4750           gtk_widget_queue_draw (widget);
4751         }
4752       else if (event->button == 3 && event->type == GDK_BUTTON_PRESS)
4753         {
4754           info->link_clicked = 1;
4755           gtk_label_do_popup (label, event);
4756           return TRUE;
4757         }
4758     }
4759
4760   if (!info->selectable)
4761     return FALSE;
4762
4763   info->in_drag = FALSE;
4764   info->select_words = FALSE;
4765
4766   if (event->button == 1)
4767     {
4768       if (!gtk_widget_has_focus (widget))
4769         {
4770           priv->in_click = TRUE;
4771           gtk_widget_grab_focus (widget);
4772           priv->in_click = FALSE;
4773         }
4774
4775       if (event->type == GDK_3BUTTON_PRESS)
4776         {
4777           gtk_label_select_region_index (label, 0, strlen (priv->text));
4778           return TRUE;
4779         }
4780
4781       if (event->type == GDK_2BUTTON_PRESS)
4782         {
4783           info->select_words = TRUE;
4784           gtk_label_select_word (label);
4785           return TRUE;
4786         }
4787
4788       get_layout_index (label, event->x, event->y, &index);
4789
4790       min = MIN (info->selection_anchor, info->selection_end);
4791       max = MAX (info->selection_anchor, info->selection_end);
4792
4793       if ((info->selection_anchor != info->selection_end) &&
4794           (event->state & GDK_SHIFT_MASK))
4795         {
4796           /* extend (same as motion) */
4797           min = MIN (min, index);
4798           max = MAX (max, index);
4799
4800           /* ensure the anchor is opposite index */
4801           if (index == min)
4802             {
4803               gint tmp = min;
4804               min = max;
4805               max = tmp;
4806             }
4807
4808           gtk_label_select_region_index (label, min, max);
4809         }
4810       else
4811         {
4812           if (event->type == GDK_3BUTTON_PRESS)
4813             gtk_label_select_region_index (label, 0, strlen (priv->text));
4814           else if (event->type == GDK_2BUTTON_PRESS)
4815             gtk_label_select_word (label);
4816           else if (min < max && min <= index && index <= max)
4817             {
4818               info->in_drag = TRUE;
4819               info->drag_start_x = event->x;
4820               info->drag_start_y = event->y;
4821             }
4822           else
4823             /* start a replacement */
4824             gtk_label_select_region_index (label, index, index);
4825         }
4826
4827       return TRUE;
4828     }
4829   else if (event->button == 3 && event->type == GDK_BUTTON_PRESS)
4830     {
4831       gtk_label_do_popup (label, event);
4832
4833       return TRUE;
4834     }
4835   return FALSE;
4836 }
4837
4838 static gboolean
4839 gtk_label_button_release (GtkWidget      *widget,
4840                           GdkEventButton *event)
4841
4842 {
4843   GtkLabel *label = GTK_LABEL (widget);
4844   GtkLabelPrivate *priv = label->priv;
4845   GtkLabelSelectionInfo *info = priv->select_info;
4846   gint index;
4847
4848   if (info == NULL)
4849     return FALSE;
4850
4851   if (info->in_drag)
4852     {
4853       info->in_drag = 0;
4854
4855       get_layout_index (label, event->x, event->y, &index);
4856       gtk_label_select_region_index (label, index, index);
4857
4858       return FALSE;
4859     }
4860
4861   if (event->button != 1)
4862     return FALSE;
4863
4864   if (info->active_link &&
4865       info->selection_anchor == info->selection_end &&
4866       info->link_clicked)
4867     {
4868       emit_activate_link (label, info->active_link);
4869       info->link_clicked = 0;
4870
4871       return TRUE;
4872     }
4873
4874   /* The goal here is to return TRUE iff we ate the
4875    * button press to start selecting.
4876    */
4877   return TRUE;
4878 }
4879
4880 static void
4881 connect_mnemonics_visible_notify (GtkLabel *label)
4882 {
4883   GtkLabelPrivate *priv = label->priv;
4884   GtkWidget *toplevel;
4885   gboolean connected;
4886
4887   toplevel = gtk_widget_get_toplevel (GTK_WIDGET (label));
4888
4889   if (!GTK_IS_WINDOW (toplevel))
4890     return;
4891
4892   /* always set up this widgets initial value */
4893   priv->mnemonics_visible =
4894     gtk_window_get_mnemonics_visible (GTK_WINDOW (toplevel));
4895
4896   connected =
4897     GPOINTER_TO_INT (g_object_get_data (G_OBJECT (toplevel),
4898                                         "gtk-label-mnemonics-visible-connected"));
4899
4900   if (!connected)
4901     {
4902       g_signal_connect (toplevel,
4903                         "notify::mnemonics-visible",
4904                         G_CALLBACK (label_mnemonics_visible_changed),
4905                         label);
4906       g_object_set_data (G_OBJECT (toplevel),
4907                          "gtk-label-mnemonics-visible-connected",
4908                          GINT_TO_POINTER (1));
4909     }
4910 }
4911
4912 static void
4913 drag_begin_cb (GtkWidget      *widget,
4914                GdkDragContext *context,
4915                gpointer        data)
4916 {
4917   GtkLabel *label = GTK_LABEL (widget);
4918   GtkLabelPrivate *priv = label->priv;
4919   cairo_surface_t *surface = NULL;
4920
4921   g_signal_handlers_disconnect_by_func (widget, drag_begin_cb, NULL);
4922
4923   if ((priv->select_info->selection_anchor !=
4924        priv->select_info->selection_end) &&
4925       priv->text)
4926     {
4927       gint start, end;
4928       gint len;
4929
4930       start = MIN (priv->select_info->selection_anchor,
4931                    priv->select_info->selection_end);
4932       end = MAX (priv->select_info->selection_anchor,
4933                  priv->select_info->selection_end);
4934
4935       len = strlen (priv->text);
4936
4937       if (end > len)
4938         end = len;
4939
4940       if (start > len)
4941         start = len;
4942
4943       surface = _gtk_text_util_create_drag_icon (widget,
4944                                                  priv->text + start,
4945                                                  end - start);
4946     }
4947
4948   if (surface)
4949     {
4950       gtk_drag_set_icon_surface (context, surface);
4951       cairo_surface_destroy (surface);
4952     }
4953   else
4954     {
4955       gtk_drag_set_icon_default (context);
4956     }
4957 }
4958
4959 static gboolean
4960 gtk_label_motion (GtkWidget      *widget,
4961                   GdkEventMotion *event)
4962 {
4963   GtkLabel *label = GTK_LABEL (widget);
4964   GtkLabelPrivate *priv = label->priv;
4965   GtkLabelSelectionInfo *info = priv->select_info;
4966   gint index;
4967
4968   if (info == NULL)
4969     return FALSE;
4970
4971   if (info->links && !info->in_drag)
4972     {
4973       GList *l;
4974       GtkLabelLink *link;
4975       gboolean found = FALSE;
4976
4977       if (info->selection_anchor == info->selection_end)
4978         {
4979           if (get_layout_index (label, event->x, event->y, &index))
4980             {
4981               for (l = info->links; l != NULL; l = l->next)
4982                 {
4983                   link = l->data;
4984                   if (index >= link->start && index <= link->end)
4985                     {
4986                       found = TRUE;
4987                       break;
4988                     }
4989                 }
4990             }
4991         }
4992
4993       if (found)
4994         {
4995           if (info->active_link != link)
4996             {
4997               info->link_clicked = 0;
4998               info->active_link = link;
4999               gtk_label_update_cursor (label);
5000               gtk_widget_queue_draw (widget);
5001             }
5002         }
5003       else
5004         {
5005           if (info->active_link != NULL)
5006             {
5007               info->link_clicked = 0;
5008               info->active_link = NULL;
5009               gtk_label_update_cursor (label);
5010               gtk_widget_queue_draw (widget);
5011             }
5012         }
5013     }
5014
5015   if (!info->selectable)
5016     return FALSE;
5017
5018   if ((event->state & GDK_BUTTON1_MASK) == 0)
5019     return FALSE;
5020
5021   if (info->in_drag)
5022     {
5023       if (gtk_drag_check_threshold (widget,
5024                                     info->drag_start_x,
5025                                     info->drag_start_y,
5026                                     event->x, event->y))
5027         {
5028           GtkTargetList *target_list = gtk_target_list_new (NULL, 0);
5029
5030           gtk_target_list_add_text_targets (target_list, 0);
5031
5032           g_signal_connect (widget, "drag-begin",
5033                             G_CALLBACK (drag_begin_cb), NULL);
5034           gtk_drag_begin (widget, target_list,
5035                           GDK_ACTION_COPY,
5036                           1, (GdkEvent *)event);
5037
5038           info->in_drag = FALSE;
5039
5040           gtk_target_list_unref (target_list);
5041         }
5042     }
5043   else
5044     {
5045       gint x, y;
5046
5047       gdk_window_get_device_position (info->window, event->device, &x, &y, NULL);
5048       get_layout_index (label, x, y, &index);
5049
5050       if (info->select_words)
5051         {
5052           gint min, max;
5053           gint old_min, old_max;
5054           gint anchor, end;
5055
5056           min = gtk_label_move_backward_word (label, index);
5057           max = gtk_label_move_forward_word (label, index);
5058
5059           anchor = info->selection_anchor;
5060           end = info->selection_end;
5061
5062           old_min = MIN (anchor, end);
5063           old_max = MAX (anchor, end);
5064
5065           if (min < old_min)
5066             {
5067               anchor = min;
5068               end = old_max;
5069             }
5070           else if (old_max < max)
5071             {
5072               anchor = max;
5073               end = old_min;
5074             }
5075           else if (anchor == old_min)
5076             {
5077               if (anchor != min)
5078                 anchor = max;
5079             }
5080           else
5081             {
5082               if (anchor != max)
5083                 anchor = min;
5084             }
5085
5086           gtk_label_select_region_index (label, anchor, end);
5087         }
5088       else
5089         gtk_label_select_region_index (label, info->selection_anchor, index);
5090     }
5091
5092   return TRUE;
5093 }
5094
5095 static gboolean
5096 gtk_label_leave_notify (GtkWidget        *widget,
5097                         GdkEventCrossing *event)
5098 {
5099   GtkLabel *label = GTK_LABEL (widget);
5100   GtkLabelPrivate *priv = label->priv;
5101
5102   if (priv->select_info)
5103     {
5104       priv->select_info->active_link = NULL;
5105       gtk_label_update_cursor (label);
5106       gtk_widget_queue_draw (widget);
5107     }
5108
5109   if (GTK_WIDGET_CLASS (gtk_label_parent_class)->leave_notify_event)
5110     return GTK_WIDGET_CLASS (gtk_label_parent_class)->leave_notify_event (widget, event);
5111
5112  return FALSE;
5113 }
5114
5115 static void
5116 gtk_label_create_window (GtkLabel *label)
5117 {
5118   GtkLabelPrivate *priv = label->priv;
5119   GtkAllocation allocation;
5120   GtkWidget *widget;
5121   GdkWindowAttr attributes;
5122   gint attributes_mask;
5123
5124   g_assert (priv->select_info);
5125   widget = GTK_WIDGET (label);
5126   g_assert (gtk_widget_get_realized (widget));
5127
5128   if (priv->select_info->window)
5129     return;
5130
5131   gtk_widget_get_allocation (widget, &allocation);
5132
5133   attributes.x = allocation.x;
5134   attributes.y = allocation.y;
5135   attributes.width = allocation.width;
5136   attributes.height = allocation.height;
5137   attributes.window_type = GDK_WINDOW_CHILD;
5138   attributes.wclass = GDK_INPUT_ONLY;
5139   attributes.override_redirect = TRUE;
5140   attributes.event_mask = gtk_widget_get_events (widget) |
5141     GDK_BUTTON_PRESS_MASK        |
5142     GDK_BUTTON_RELEASE_MASK      |
5143     GDK_LEAVE_NOTIFY_MASK        |
5144     GDK_BUTTON_MOTION_MASK       |
5145     GDK_POINTER_MOTION_MASK      |
5146     GDK_POINTER_MOTION_HINT_MASK;
5147   attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_NOREDIR;
5148   if (gtk_widget_is_sensitive (widget))
5149     {
5150       attributes.cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget),
5151                                                       GDK_XTERM);
5152       attributes_mask |= GDK_WA_CURSOR;
5153     }
5154
5155
5156   priv->select_info->window = gdk_window_new (gtk_widget_get_window (widget),
5157                                                &attributes, attributes_mask);
5158   gdk_window_set_user_data (priv->select_info->window, widget);
5159
5160   if (attributes_mask & GDK_WA_CURSOR)
5161     g_object_unref (attributes.cursor);
5162 }
5163
5164 static void
5165 gtk_label_destroy_window (GtkLabel *label)
5166 {
5167   GtkLabelPrivate *priv = label->priv;
5168
5169   g_assert (priv->select_info);
5170
5171   if (priv->select_info->window == NULL)
5172     return;
5173
5174   gdk_window_set_user_data (priv->select_info->window, NULL);
5175   gdk_window_destroy (priv->select_info->window);
5176   priv->select_info->window = NULL;
5177 }
5178
5179 static void
5180 gtk_label_ensure_select_info (GtkLabel *label)
5181 {
5182   GtkLabelPrivate *priv = label->priv;
5183
5184   if (priv->select_info == NULL)
5185     {
5186       priv->select_info = g_new0 (GtkLabelSelectionInfo, 1);
5187
5188       gtk_widget_set_can_focus (GTK_WIDGET (label), TRUE);
5189
5190       if (gtk_widget_get_realized (GTK_WIDGET (label)))
5191         gtk_label_create_window (label);
5192
5193       if (gtk_widget_get_mapped (GTK_WIDGET (label)))
5194         gdk_window_show (priv->select_info->window);
5195     }
5196 }
5197
5198 static void
5199 gtk_label_clear_select_info (GtkLabel *label)
5200 {
5201   GtkLabelPrivate *priv = label->priv;
5202
5203   if (priv->select_info == NULL)
5204     return;
5205
5206   if (!priv->select_info->selectable && !priv->select_info->links)
5207     {
5208       gtk_label_destroy_window (label);
5209
5210       g_free (priv->select_info);
5211       priv->select_info = NULL;
5212
5213       gtk_widget_set_can_focus (GTK_WIDGET (label), FALSE);
5214     }
5215 }
5216
5217 /**
5218  * gtk_label_set_selectable:
5219  * @label: a #GtkLabel
5220  * @setting: %TRUE to allow selecting text in the label
5221  *
5222  * Selectable labels allow the user to select text from the label, for
5223  * copy-and-paste.
5224  **/
5225 void
5226 gtk_label_set_selectable (GtkLabel *label,
5227                           gboolean  setting)
5228 {
5229   GtkLabelPrivate *priv;
5230   gboolean old_setting;
5231
5232   g_return_if_fail (GTK_IS_LABEL (label));
5233
5234   priv = label->priv;
5235
5236   setting = setting != FALSE;
5237   old_setting = priv->select_info && priv->select_info->selectable;
5238
5239   if (setting)
5240     {
5241       gtk_label_ensure_select_info (label);
5242       priv->select_info->selectable = TRUE;
5243       gtk_label_update_cursor (label);
5244     }
5245   else
5246     {
5247       if (old_setting)
5248         {
5249           /* unselect, to give up the selection */
5250           gtk_label_select_region (label, 0, 0);
5251
5252           priv->select_info->selectable = FALSE;
5253           gtk_label_clear_select_info (label);
5254           gtk_label_update_cursor (label);
5255         }
5256     }
5257   if (setting != old_setting)
5258     {
5259       g_object_freeze_notify (G_OBJECT (label));
5260       g_object_notify (G_OBJECT (label), "selectable");
5261       g_object_notify (G_OBJECT (label), "cursor-position");
5262       g_object_notify (G_OBJECT (label), "selection-bound");
5263       g_object_thaw_notify (G_OBJECT (label));
5264       gtk_widget_queue_draw (GTK_WIDGET (label));
5265     }
5266 }
5267
5268 /**
5269  * gtk_label_get_selectable:
5270  * @label: a #GtkLabel
5271  *
5272  * Gets the value set by gtk_label_set_selectable().
5273  *
5274  * Return value: %TRUE if the user can copy text from the label
5275  **/
5276 gboolean
5277 gtk_label_get_selectable (GtkLabel *label)
5278 {
5279   GtkLabelPrivate *priv;
5280
5281   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5282
5283   priv = label->priv;
5284
5285   return priv->select_info && priv->select_info->selectable;
5286 }
5287
5288 /**
5289  * gtk_label_set_angle:
5290  * @label: a #GtkLabel
5291  * @angle: the angle that the baseline of the label makes with
5292  *   the horizontal, in degrees, measured counterclockwise
5293  *
5294  * Sets the angle of rotation for the label. An angle of 90 reads from
5295  * from bottom to top, an angle of 270, from top to bottom. The angle
5296  * setting for the label is ignored if the label is selectable,
5297  * wrapped, or ellipsized.
5298  *
5299  * Since: 2.6
5300  **/
5301 void
5302 gtk_label_set_angle (GtkLabel *label,
5303                      gdouble   angle)
5304 {
5305   GtkLabelPrivate *priv;
5306
5307   g_return_if_fail (GTK_IS_LABEL (label));
5308
5309   priv = label->priv;
5310
5311   /* Canonicalize to [0,360]. We don't canonicalize 360 to 0, because
5312    * double property ranges are inclusive, and changing 360 to 0 would
5313    * make a property editor behave strangely.
5314    */
5315   if (angle < 0 || angle > 360.0)
5316     angle = angle - 360. * floor (angle / 360.);
5317
5318   if (priv->angle != angle)
5319     {
5320       priv->angle = angle;
5321
5322       gtk_label_clear_layout (label);
5323       gtk_widget_queue_resize (GTK_WIDGET (label));
5324
5325       g_object_notify (G_OBJECT (label), "angle");
5326     }
5327 }
5328
5329 /**
5330  * gtk_label_get_angle:
5331  * @label: a #GtkLabel
5332  *
5333  * Gets the angle of rotation for the label. See
5334  * gtk_label_set_angle().
5335  *
5336  * Return value: the angle of rotation for the label
5337  *
5338  * Since: 2.6
5339  **/
5340 gdouble
5341 gtk_label_get_angle  (GtkLabel *label)
5342 {
5343   g_return_val_if_fail (GTK_IS_LABEL (label), 0.0);
5344
5345   return label->priv->angle;
5346 }
5347
5348 static void
5349 gtk_label_set_selection_text (GtkLabel         *label,
5350                               GtkSelectionData *selection_data)
5351 {
5352   GtkLabelPrivate *priv = label->priv;
5353
5354   if ((priv->select_info->selection_anchor !=
5355        priv->select_info->selection_end) &&
5356       priv->text)
5357     {
5358       gint start, end;
5359       gint len;
5360
5361       start = MIN (priv->select_info->selection_anchor,
5362                    priv->select_info->selection_end);
5363       end = MAX (priv->select_info->selection_anchor,
5364                  priv->select_info->selection_end);
5365
5366       len = strlen (priv->text);
5367
5368       if (end > len)
5369         end = len;
5370
5371       if (start > len)
5372         start = len;
5373
5374       gtk_selection_data_set_text (selection_data,
5375                                    priv->text + start,
5376                                    end - start);
5377     }
5378 }
5379
5380 static void
5381 gtk_label_drag_data_get (GtkWidget        *widget,
5382                          GdkDragContext   *context,
5383                          GtkSelectionData *selection_data,
5384                          guint             info,
5385                          guint             time)
5386 {
5387   gtk_label_set_selection_text (GTK_LABEL (widget), selection_data);
5388 }
5389
5390 static void
5391 get_text_callback (GtkClipboard     *clipboard,
5392                    GtkSelectionData *selection_data,
5393                    guint             info,
5394                    gpointer          user_data_or_owner)
5395 {
5396   gtk_label_set_selection_text (GTK_LABEL (user_data_or_owner), selection_data);
5397 }
5398
5399 static void
5400 clear_text_callback (GtkClipboard     *clipboard,
5401                      gpointer          user_data_or_owner)
5402 {
5403   GtkLabel *label;
5404   GtkLabelPrivate *priv;
5405
5406   label = GTK_LABEL (user_data_or_owner);
5407   priv = label->priv;
5408
5409   if (priv->select_info)
5410     {
5411       priv->select_info->selection_anchor = priv->select_info->selection_end;
5412
5413       gtk_widget_queue_draw (GTK_WIDGET (label));
5414     }
5415 }
5416
5417 static void
5418 gtk_label_select_region_index (GtkLabel *label,
5419                                gint      anchor_index,
5420                                gint      end_index)
5421 {
5422   GtkLabelPrivate *priv;
5423
5424   g_return_if_fail (GTK_IS_LABEL (label));
5425
5426   priv = label->priv;
5427
5428   if (priv->select_info && priv->select_info->selectable)
5429     {
5430       GtkClipboard *clipboard;
5431
5432       if (priv->select_info->selection_anchor == anchor_index &&
5433           priv->select_info->selection_end == end_index)
5434         return;
5435
5436       priv->select_info->selection_anchor = anchor_index;
5437       priv->select_info->selection_end = end_index;
5438
5439       clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label),
5440                                             GDK_SELECTION_PRIMARY);
5441
5442       if (anchor_index != end_index)
5443         {
5444           GtkTargetList *list;
5445           GtkTargetEntry *targets;
5446           gint n_targets;
5447
5448           list = gtk_target_list_new (NULL, 0);
5449           gtk_target_list_add_text_targets (list, 0);
5450           targets = gtk_target_table_new_from_list (list, &n_targets);
5451
5452           gtk_clipboard_set_with_owner (clipboard,
5453                                         targets, n_targets,
5454                                         get_text_callback,
5455                                         clear_text_callback,
5456                                         G_OBJECT (label));
5457
5458           gtk_target_table_free (targets, n_targets);
5459           gtk_target_list_unref (list);
5460         }
5461       else
5462         {
5463           if (gtk_clipboard_get_owner (clipboard) == G_OBJECT (label))
5464             gtk_clipboard_clear (clipboard);
5465         }
5466
5467       gtk_widget_queue_draw (GTK_WIDGET (label));
5468
5469       g_object_freeze_notify (G_OBJECT (label));
5470       g_object_notify (G_OBJECT (label), "cursor-position");
5471       g_object_notify (G_OBJECT (label), "selection-bound");
5472       g_object_thaw_notify (G_OBJECT (label));
5473     }
5474 }
5475
5476 /**
5477  * gtk_label_select_region:
5478  * @label: a #GtkLabel
5479  * @start_offset: start offset (in characters not bytes)
5480  * @end_offset: end offset (in characters not bytes)
5481  *
5482  * Selects a range of characters in the label, if the label is selectable.
5483  * See gtk_label_set_selectable(). If the label is not selectable,
5484  * this function has no effect. If @start_offset or
5485  * @end_offset are -1, then the end of the label will be substituted.
5486  **/
5487 void
5488 gtk_label_select_region  (GtkLabel *label,
5489                           gint      start_offset,
5490                           gint      end_offset)
5491 {
5492   GtkLabelPrivate *priv;
5493
5494   g_return_if_fail (GTK_IS_LABEL (label));
5495
5496   priv = label->priv;
5497
5498   if (priv->text && priv->select_info)
5499     {
5500       if (start_offset < 0)
5501         start_offset = g_utf8_strlen (priv->text, -1);
5502
5503       if (end_offset < 0)
5504         end_offset = g_utf8_strlen (priv->text, -1);
5505
5506       gtk_label_select_region_index (label,
5507                                      g_utf8_offset_to_pointer (priv->text, start_offset) - priv->text,
5508                                      g_utf8_offset_to_pointer (priv->text, end_offset) - priv->text);
5509     }
5510 }
5511
5512 /**
5513  * gtk_label_get_selection_bounds:
5514  * @label: a #GtkLabel
5515  * @start: (out): return location for start of selection, as a character offset
5516  * @end: (out): return location for end of selection, as a character offset
5517  *
5518  * Gets the selected range of characters in the label, returning %TRUE
5519  * if there's a selection.
5520  *
5521  * Return value: %TRUE if selection is non-empty
5522  **/
5523 gboolean
5524 gtk_label_get_selection_bounds (GtkLabel  *label,
5525                                 gint      *start,
5526                                 gint      *end)
5527 {
5528   GtkLabelPrivate *priv;
5529
5530   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5531
5532   priv = label->priv;
5533
5534   if (priv->select_info == NULL)
5535     {
5536       /* not a selectable label */
5537       if (start)
5538         *start = 0;
5539       if (end)
5540         *end = 0;
5541
5542       return FALSE;
5543     }
5544   else
5545     {
5546       gint start_index, end_index;
5547       gint start_offset, end_offset;
5548       gint len;
5549
5550       start_index = MIN (priv->select_info->selection_anchor,
5551                    priv->select_info->selection_end);
5552       end_index = MAX (priv->select_info->selection_anchor,
5553                  priv->select_info->selection_end);
5554
5555       len = strlen (priv->text);
5556
5557       if (end_index > len)
5558         end_index = len;
5559
5560       if (start_index > len)
5561         start_index = len;
5562
5563       start_offset = g_utf8_strlen (priv->text, start_index);
5564       end_offset = g_utf8_strlen (priv->text, end_index);
5565
5566       if (start_offset > end_offset)
5567         {
5568           gint tmp = start_offset;
5569           start_offset = end_offset;
5570           end_offset = tmp;
5571         }
5572
5573       if (start)
5574         *start = start_offset;
5575
5576       if (end)
5577         *end = end_offset;
5578
5579       return start_offset != end_offset;
5580     }
5581 }
5582
5583
5584 /**
5585  * gtk_label_get_layout:
5586  * @label: a #GtkLabel
5587  *
5588  * Gets the #PangoLayout used to display the label.
5589  * The layout is useful to e.g. convert text positions to
5590  * pixel positions, in combination with gtk_label_get_layout_offsets().
5591  * The returned layout is owned by the @label so need not be
5592  * freed by the caller. The @label is free to recreate its layout at
5593  * any time, so it should be considered read-only.
5594  *
5595  * Return value: (transfer none): the #PangoLayout for this label
5596  **/
5597 PangoLayout*
5598 gtk_label_get_layout (GtkLabel *label)
5599 {
5600   GtkLabelPrivate *priv;
5601
5602   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
5603
5604   priv = label->priv;
5605
5606   gtk_label_ensure_layout (label);
5607
5608   return priv->layout;
5609 }
5610
5611 /**
5612  * gtk_label_get_layout_offsets:
5613  * @label: a #GtkLabel
5614  * @x: (out) (allow-none): location to store X offset of layout, or %NULL
5615  * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
5616  *
5617  * Obtains the coordinates where the label will draw the #PangoLayout
5618  * representing the text in the label; useful to convert mouse events
5619  * into coordinates inside the #PangoLayout, e.g. to take some action
5620  * if some part of the label is clicked. Of course you will need to
5621  * create a #GtkEventBox to receive the events, and pack the label
5622  * inside it, since labels are a #GTK_NO_WINDOW widget. Remember
5623  * when using the #PangoLayout functions you need to convert to
5624  * and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
5625  **/
5626 void
5627 gtk_label_get_layout_offsets (GtkLabel *label,
5628                               gint     *x,
5629                               gint     *y)
5630 {
5631   g_return_if_fail (GTK_IS_LABEL (label));
5632
5633   gtk_label_ensure_layout (label);
5634
5635   get_layout_location (label, x, y);
5636 }
5637
5638 /**
5639  * gtk_label_set_use_markup:
5640  * @label: a #GtkLabel
5641  * @setting: %TRUE if the label's text should be parsed for markup.
5642  *
5643  * Sets whether the text of the label contains markup in <link
5644  * linkend="PangoMarkupFormat">Pango's text markup
5645  * language</link>. See gtk_label_set_markup().
5646  **/
5647 void
5648 gtk_label_set_use_markup (GtkLabel *label,
5649                           gboolean  setting)
5650 {
5651   g_return_if_fail (GTK_IS_LABEL (label));
5652
5653   gtk_label_set_use_markup_internal (label, setting);
5654   gtk_label_recalculate (label);
5655 }
5656
5657 /**
5658  * gtk_label_get_use_markup:
5659  * @label: a #GtkLabel
5660  *
5661  * Returns whether the label's text is interpreted as marked up with
5662  * the <link linkend="PangoMarkupFormat">Pango text markup
5663  * language</link>. See gtk_label_set_use_markup ().
5664  *
5665  * Return value: %TRUE if the label's text will be parsed for markup.
5666  **/
5667 gboolean
5668 gtk_label_get_use_markup (GtkLabel *label)
5669 {
5670   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5671
5672   return label->priv->use_markup;
5673 }
5674
5675 /**
5676  * gtk_label_set_use_underline:
5677  * @label: a #GtkLabel
5678  * @setting: %TRUE if underlines in the text indicate mnemonics
5679  *
5680  * If true, an underline in the text indicates the next character should be
5681  * used for the mnemonic accelerator key.
5682  */
5683 void
5684 gtk_label_set_use_underline (GtkLabel *label,
5685                              gboolean  setting)
5686 {
5687   g_return_if_fail (GTK_IS_LABEL (label));
5688
5689   gtk_label_set_use_underline_internal (label, setting);
5690   gtk_label_recalculate (label);
5691 }
5692
5693 /**
5694  * gtk_label_get_use_underline:
5695  * @label: a #GtkLabel
5696  *
5697  * Returns whether an embedded underline in the label indicates a
5698  * mnemonic. See gtk_label_set_use_underline().
5699  *
5700  * Return value: %TRUE whether an embedded underline in the label indicates
5701  *               the mnemonic accelerator keys.
5702  **/
5703 gboolean
5704 gtk_label_get_use_underline (GtkLabel *label)
5705 {
5706   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5707
5708   return label->priv->use_underline;
5709 }
5710
5711 /**
5712  * gtk_label_set_single_line_mode:
5713  * @label: a #GtkLabel
5714  * @single_line_mode: %TRUE if the label should be in single line mode
5715  *
5716  * Sets whether the label is in single line mode.
5717  *
5718  * Since: 2.6
5719  */
5720 void
5721 gtk_label_set_single_line_mode (GtkLabel *label,
5722                                 gboolean single_line_mode)
5723 {
5724   GtkLabelPrivate *priv;
5725
5726   g_return_if_fail (GTK_IS_LABEL (label));
5727
5728   priv = label->priv;
5729
5730   single_line_mode = single_line_mode != FALSE;
5731
5732   if (priv->single_line_mode != single_line_mode)
5733     {
5734       priv->single_line_mode = single_line_mode;
5735
5736       gtk_label_clear_layout (label);
5737       gtk_widget_queue_resize (GTK_WIDGET (label));
5738
5739       g_object_notify (G_OBJECT (label), "single-line-mode");
5740     }
5741 }
5742
5743 /**
5744  * gtk_label_get_single_line_mode:
5745  * @label: a #GtkLabel
5746  *
5747  * Returns whether the label is in single line mode.
5748  *
5749  * Return value: %TRUE when the label is in single line mode.
5750  *
5751  * Since: 2.6
5752  **/
5753 gboolean
5754 gtk_label_get_single_line_mode  (GtkLabel *label)
5755 {
5756   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5757
5758   return label->priv->single_line_mode;
5759 }
5760
5761 /* Compute the X position for an offset that corresponds to the "more important
5762  * cursor position for that offset. We use this when trying to guess to which
5763  * end of the selection we should go to when the user hits the left or
5764  * right arrow key.
5765  */
5766 static void
5767 get_better_cursor (GtkLabel *label,
5768                    gint      index,
5769                    gint      *x,
5770                    gint      *y)
5771 {
5772   GtkLabelPrivate *priv = label->priv;
5773   GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
5774   PangoDirection keymap_direction = gdk_keymap_get_direction (keymap);
5775   PangoDirection cursor_direction = get_cursor_direction (label);
5776   gboolean split_cursor;
5777   PangoRectangle strong_pos, weak_pos;
5778
5779   g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
5780                 "gtk-split-cursor", &split_cursor,
5781                 NULL);
5782
5783   gtk_label_ensure_layout (label);
5784
5785   pango_layout_get_cursor_pos (priv->layout, index,
5786                                &strong_pos, &weak_pos);
5787
5788   if (split_cursor)
5789     {
5790       *x = strong_pos.x / PANGO_SCALE;
5791       *y = strong_pos.y / PANGO_SCALE;
5792     }
5793   else
5794     {
5795       if (keymap_direction == cursor_direction)
5796         {
5797           *x = strong_pos.x / PANGO_SCALE;
5798           *y = strong_pos.y / PANGO_SCALE;
5799         }
5800       else
5801         {
5802           *x = weak_pos.x / PANGO_SCALE;
5803           *y = weak_pos.y / PANGO_SCALE;
5804         }
5805     }
5806 }
5807
5808
5809 static gint
5810 gtk_label_move_logically (GtkLabel *label,
5811                           gint      start,
5812                           gint      count)
5813 {
5814   GtkLabelPrivate *priv = label->priv;
5815   gint offset = g_utf8_pointer_to_offset (priv->text,
5816                                           priv->text + start);
5817
5818   if (priv->text)
5819     {
5820       PangoLogAttr *log_attrs;
5821       gint n_attrs;
5822       gint length;
5823
5824       gtk_label_ensure_layout (label);
5825
5826       length = g_utf8_strlen (priv->text, -1);
5827
5828       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5829
5830       while (count > 0 && offset < length)
5831         {
5832           do
5833             offset++;
5834           while (offset < length && !log_attrs[offset].is_cursor_position);
5835
5836           count--;
5837         }
5838       while (count < 0 && offset > 0)
5839         {
5840           do
5841             offset--;
5842           while (offset > 0 && !log_attrs[offset].is_cursor_position);
5843
5844           count++;
5845         }
5846
5847       g_free (log_attrs);
5848     }
5849
5850   return g_utf8_offset_to_pointer (priv->text, offset) - priv->text;
5851 }
5852
5853 static gint
5854 gtk_label_move_visually (GtkLabel *label,
5855                          gint      start,
5856                          gint      count)
5857 {
5858   GtkLabelPrivate *priv = label->priv;
5859   gint index;
5860
5861   index = start;
5862
5863   while (count != 0)
5864     {
5865       int new_index, new_trailing;
5866       gboolean split_cursor;
5867       gboolean strong;
5868
5869       gtk_label_ensure_layout (label);
5870
5871       g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
5872                     "gtk-split-cursor", &split_cursor,
5873                     NULL);
5874
5875       if (split_cursor)
5876         strong = TRUE;
5877       else
5878         {
5879           GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
5880           PangoDirection keymap_direction = gdk_keymap_get_direction (keymap);
5881
5882           strong = keymap_direction == get_cursor_direction (label);
5883         }
5884
5885       if (count > 0)
5886         {
5887           pango_layout_move_cursor_visually (priv->layout, strong, index, 0, 1, &new_index, &new_trailing);
5888           count--;
5889         }
5890       else
5891         {
5892           pango_layout_move_cursor_visually (priv->layout, strong, index, 0, -1, &new_index, &new_trailing);
5893           count++;
5894         }
5895
5896       if (new_index < 0 || new_index == G_MAXINT)
5897         break;
5898
5899       index = new_index;
5900
5901       while (new_trailing--)
5902         index = g_utf8_next_char (priv->text + new_index) - priv->text;
5903     }
5904
5905   return index;
5906 }
5907
5908 static gint
5909 gtk_label_move_forward_word (GtkLabel *label,
5910                              gint      start)
5911 {
5912   GtkLabelPrivate *priv = label->priv;
5913   gint new_pos = g_utf8_pointer_to_offset (priv->text,
5914                                            priv->text + start);
5915   gint length;
5916
5917   length = g_utf8_strlen (priv->text, -1);
5918   if (new_pos < length)
5919     {
5920       PangoLogAttr *log_attrs;
5921       gint n_attrs;
5922
5923       gtk_label_ensure_layout (label);
5924
5925       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5926
5927       /* Find the next word end */
5928       new_pos++;
5929       while (new_pos < n_attrs && !log_attrs[new_pos].is_word_end)
5930         new_pos++;
5931
5932       g_free (log_attrs);
5933     }
5934
5935   return g_utf8_offset_to_pointer (priv->text, new_pos) - priv->text;
5936 }
5937
5938
5939 static gint
5940 gtk_label_move_backward_word (GtkLabel *label,
5941                               gint      start)
5942 {
5943   GtkLabelPrivate *priv = label->priv;
5944   gint new_pos = g_utf8_pointer_to_offset (priv->text,
5945                                            priv->text + start);
5946
5947   if (new_pos > 0)
5948     {
5949       PangoLogAttr *log_attrs;
5950       gint n_attrs;
5951
5952       gtk_label_ensure_layout (label);
5953
5954       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5955
5956       new_pos -= 1;
5957
5958       /* Find the previous word beginning */
5959       while (new_pos > 0 && !log_attrs[new_pos].is_word_start)
5960         new_pos--;
5961
5962       g_free (log_attrs);
5963     }
5964
5965   return g_utf8_offset_to_pointer (priv->text, new_pos) - priv->text;
5966 }
5967
5968 static void
5969 gtk_label_move_cursor (GtkLabel       *label,
5970                        GtkMovementStep step,
5971                        gint            count,
5972                        gboolean        extend_selection)
5973 {
5974   GtkLabelPrivate *priv = label->priv;
5975   gint old_pos;
5976   gint new_pos;
5977
5978   if (priv->select_info == NULL)
5979     return;
5980
5981   old_pos = new_pos = priv->select_info->selection_end;
5982
5983   if (priv->select_info->selection_end != priv->select_info->selection_anchor &&
5984       !extend_selection)
5985     {
5986       /* If we have a current selection and aren't extending it, move to the
5987        * start/or end of the selection as appropriate
5988        */
5989       switch (step)
5990         {
5991         case GTK_MOVEMENT_VISUAL_POSITIONS:
5992           {
5993             gint end_x, end_y;
5994             gint anchor_x, anchor_y;
5995             gboolean end_is_left;
5996
5997             get_better_cursor (label, priv->select_info->selection_end, &end_x, &end_y);
5998             get_better_cursor (label, priv->select_info->selection_anchor, &anchor_x, &anchor_y);
5999
6000             end_is_left = (end_y < anchor_y) || (end_y == anchor_y && end_x < anchor_x);
6001
6002             if (count < 0)
6003               new_pos = end_is_left ? priv->select_info->selection_end : priv->select_info->selection_anchor;
6004             else
6005               new_pos = !end_is_left ? priv->select_info->selection_end : priv->select_info->selection_anchor;
6006             break;
6007           }
6008         case GTK_MOVEMENT_LOGICAL_POSITIONS:
6009         case GTK_MOVEMENT_WORDS:
6010           if (count < 0)
6011             new_pos = MIN (priv->select_info->selection_end, priv->select_info->selection_anchor);
6012           else
6013             new_pos = MAX (priv->select_info->selection_end, priv->select_info->selection_anchor);
6014           break;
6015         case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
6016         case GTK_MOVEMENT_PARAGRAPH_ENDS:
6017         case GTK_MOVEMENT_BUFFER_ENDS:
6018           /* FIXME: Can do better here */
6019           new_pos = count < 0 ? 0 : strlen (priv->text);
6020           break;
6021         case GTK_MOVEMENT_DISPLAY_LINES:
6022         case GTK_MOVEMENT_PARAGRAPHS:
6023         case GTK_MOVEMENT_PAGES:
6024         case GTK_MOVEMENT_HORIZONTAL_PAGES:
6025           break;
6026         }
6027     }
6028   else
6029     {
6030       switch (step)
6031         {
6032         case GTK_MOVEMENT_LOGICAL_POSITIONS:
6033           new_pos = gtk_label_move_logically (label, new_pos, count);
6034           break;
6035         case GTK_MOVEMENT_VISUAL_POSITIONS:
6036           new_pos = gtk_label_move_visually (label, new_pos, count);
6037           if (new_pos == old_pos)
6038             {
6039               if (!extend_selection)
6040                 {
6041                   if (!gtk_widget_keynav_failed (GTK_WIDGET (label),
6042                                                  count > 0 ?
6043                                                  GTK_DIR_RIGHT : GTK_DIR_LEFT))
6044                     {
6045                       GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (label));
6046
6047                       if (toplevel)
6048                         gtk_widget_child_focus (toplevel,
6049                                                 count > 0 ?
6050                                                 GTK_DIR_RIGHT : GTK_DIR_LEFT);
6051                     }
6052                 }
6053               else
6054                 {
6055                   gtk_widget_error_bell (GTK_WIDGET (label));
6056                 }
6057             }
6058           break;
6059         case GTK_MOVEMENT_WORDS:
6060           while (count > 0)
6061             {
6062               new_pos = gtk_label_move_forward_word (label, new_pos);
6063               count--;
6064             }
6065           while (count < 0)
6066             {
6067               new_pos = gtk_label_move_backward_word (label, new_pos);
6068               count++;
6069             }
6070           if (new_pos == old_pos)
6071             gtk_widget_error_bell (GTK_WIDGET (label));
6072           break;
6073         case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
6074         case GTK_MOVEMENT_PARAGRAPH_ENDS:
6075         case GTK_MOVEMENT_BUFFER_ENDS:
6076           /* FIXME: Can do better here */
6077           new_pos = count < 0 ? 0 : strlen (priv->text);
6078           if (new_pos == old_pos)
6079             gtk_widget_error_bell (GTK_WIDGET (label));
6080           break;
6081         case GTK_MOVEMENT_DISPLAY_LINES:
6082         case GTK_MOVEMENT_PARAGRAPHS:
6083         case GTK_MOVEMENT_PAGES:
6084         case GTK_MOVEMENT_HORIZONTAL_PAGES:
6085           break;
6086         }
6087     }
6088
6089   if (extend_selection)
6090     gtk_label_select_region_index (label,
6091                                    priv->select_info->selection_anchor,
6092                                    new_pos);
6093   else
6094     gtk_label_select_region_index (label, new_pos, new_pos);
6095 }
6096
6097 static void
6098 gtk_label_copy_clipboard (GtkLabel *label)
6099 {
6100   GtkLabelPrivate *priv = label->priv;
6101
6102   if (priv->text && priv->select_info)
6103     {
6104       gint start, end;
6105       gint len;
6106       GtkClipboard *clipboard;
6107
6108       start = MIN (priv->select_info->selection_anchor,
6109                    priv->select_info->selection_end);
6110       end = MAX (priv->select_info->selection_anchor,
6111                  priv->select_info->selection_end);
6112
6113       len = strlen (priv->text);
6114
6115       if (end > len)
6116         end = len;
6117
6118       if (start > len)
6119         start = len;
6120
6121       clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label), GDK_SELECTION_CLIPBOARD);
6122
6123       if (start != end)
6124         gtk_clipboard_set_text (clipboard, priv->text + start, end - start);
6125       else
6126         {
6127           GtkLabelLink *link;
6128
6129           link = gtk_label_get_focus_link (label);
6130           if (link)
6131             gtk_clipboard_set_text (clipboard, link->uri, -1);
6132         }
6133     }
6134 }
6135
6136 static void
6137 gtk_label_select_all (GtkLabel *label)
6138 {
6139   GtkLabelPrivate *priv = label->priv;
6140
6141   gtk_label_select_region_index (label, 0, strlen (priv->text));
6142 }
6143
6144 /* Quick hack of a popup menu
6145  */
6146 static void
6147 activate_cb (GtkWidget *menuitem,
6148              GtkLabel  *label)
6149 {
6150   const gchar *signal = g_object_get_data (G_OBJECT (menuitem), "gtk-signal");
6151   g_signal_emit_by_name (label, signal);
6152 }
6153
6154 static void
6155 append_action_signal (GtkLabel     *label,
6156                       GtkWidget    *menu,
6157                       const gchar  *stock_id,
6158                       const gchar  *signal,
6159                       gboolean      sensitive)
6160 {
6161   GtkWidget *menuitem = gtk_image_menu_item_new_from_stock (stock_id, NULL);
6162
6163   g_object_set_data (G_OBJECT (menuitem), I_("gtk-signal"), (char *)signal);
6164   g_signal_connect (menuitem, "activate",
6165                     G_CALLBACK (activate_cb), label);
6166
6167   gtk_widget_set_sensitive (menuitem, sensitive);
6168
6169   gtk_widget_show (menuitem);
6170   gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6171 }
6172
6173 static void
6174 popup_menu_detach (GtkWidget *attach_widget,
6175                    GtkMenu   *menu)
6176 {
6177   GtkLabel *label = GTK_LABEL (attach_widget);
6178   GtkLabelPrivate *priv = label->priv;
6179
6180   if (priv->select_info)
6181     priv->select_info->popup_menu = NULL;
6182 }
6183
6184 static void
6185 popup_position_func (GtkMenu   *menu,
6186                      gint      *x,
6187                      gint      *y,
6188                      gboolean  *push_in,
6189                      gpointer   user_data)
6190 {
6191   GtkLabel *label;
6192   GtkWidget *widget;
6193   GtkAllocation allocation;
6194   GtkRequisition req;
6195   GdkScreen *screen;
6196
6197   label = GTK_LABEL (user_data);
6198   widget = GTK_WIDGET (label);
6199
6200   g_return_if_fail (gtk_widget_get_realized (widget));
6201
6202   screen = gtk_widget_get_screen (widget);
6203   gdk_window_get_origin (gtk_widget_get_window (widget), x, y);
6204
6205   gtk_widget_get_allocation (widget, &allocation);
6206
6207   *x += allocation.x;
6208   *y += allocation.y;
6209
6210   gtk_widget_get_preferred_size (GTK_WIDGET (menu),
6211                                  &req, NULL);
6212
6213   gtk_widget_get_allocation (widget, &allocation);
6214
6215   *x += allocation.width / 2;
6216   *y += allocation.height;
6217
6218   *x = CLAMP (*x, 0, MAX (0, gdk_screen_get_width (screen) - req.width));
6219   *y = CLAMP (*y, 0, MAX (0, gdk_screen_get_height (screen) - req.height));
6220 }
6221
6222 static void
6223 open_link_activate_cb (GtkMenuItem *menu_item,
6224                        GtkLabel    *label)
6225 {
6226   GtkLabelLink *link;
6227
6228   link = gtk_label_get_current_link (label);
6229
6230   if (link)
6231     emit_activate_link (label, link);
6232 }
6233
6234 static void
6235 copy_link_activate_cb (GtkMenuItem *menu_item,
6236                        GtkLabel    *label)
6237 {
6238   GtkClipboard *clipboard;
6239   const gchar *uri;
6240
6241   uri = gtk_label_get_current_uri (label);
6242   if (uri)
6243     {
6244       clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label), GDK_SELECTION_CLIPBOARD);
6245       gtk_clipboard_set_text (clipboard, uri, -1);
6246     }
6247 }
6248
6249 static gboolean
6250 gtk_label_popup_menu (GtkWidget *widget)
6251 {
6252   gtk_label_do_popup (GTK_LABEL (widget), NULL);
6253
6254   return TRUE;
6255 }
6256
6257 static void
6258 gtk_label_do_popup (GtkLabel       *label,
6259                     GdkEventButton *event)
6260 {
6261   GtkLabelPrivate *priv = label->priv;
6262   GtkWidget *menuitem;
6263   GtkWidget *menu;
6264   GtkWidget *image;
6265   gboolean have_selection;
6266   GtkLabelLink *link;
6267
6268   if (!priv->select_info)
6269     return;
6270
6271   if (priv->select_info->popup_menu)
6272     gtk_widget_destroy (priv->select_info->popup_menu);
6273
6274   priv->select_info->popup_menu = menu = gtk_menu_new ();
6275
6276   gtk_menu_attach_to_widget (GTK_MENU (menu), GTK_WIDGET (label), popup_menu_detach);
6277
6278   have_selection =
6279     priv->select_info->selection_anchor != priv->select_info->selection_end;
6280
6281   if (event)
6282     {
6283       if (priv->select_info->link_clicked)
6284         link = priv->select_info->active_link;
6285       else
6286         link = NULL;
6287     }
6288   else
6289     link = gtk_label_get_focus_link (label);
6290
6291   if (!have_selection && link)
6292     {
6293       /* Open Link */
6294       menuitem = gtk_image_menu_item_new_with_mnemonic (_("_Open Link"));
6295       gtk_widget_show (menuitem);
6296       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6297
6298       g_signal_connect (G_OBJECT (menuitem), "activate",
6299                         G_CALLBACK (open_link_activate_cb), label);
6300
6301       image = gtk_image_new_from_stock (GTK_STOCK_JUMP_TO, GTK_ICON_SIZE_MENU);
6302       gtk_widget_show (image);
6303       gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (menuitem), image);
6304
6305       /* Copy Link Address */
6306       menuitem = gtk_image_menu_item_new_with_mnemonic (_("Copy _Link Address"));
6307       gtk_widget_show (menuitem);
6308       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6309
6310       g_signal_connect (G_OBJECT (menuitem), "activate",
6311                         G_CALLBACK (copy_link_activate_cb), label);
6312
6313       image = gtk_image_new_from_stock (GTK_STOCK_COPY, GTK_ICON_SIZE_MENU);
6314       gtk_widget_show (image);
6315       gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (menuitem), image);
6316     }
6317   else
6318     {
6319       append_action_signal (label, menu, GTK_STOCK_CUT, "cut-clipboard", FALSE);
6320       append_action_signal (label, menu, GTK_STOCK_COPY, "copy-clipboard", have_selection);
6321       append_action_signal (label, menu, GTK_STOCK_PASTE, "paste-clipboard", FALSE);
6322
6323       menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_DELETE, NULL);
6324       gtk_widget_set_sensitive (menuitem, FALSE);
6325       gtk_widget_show (menuitem);
6326       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6327
6328       menuitem = gtk_separator_menu_item_new ();
6329       gtk_widget_show (menuitem);
6330       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6331
6332       menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_SELECT_ALL, NULL);
6333       g_signal_connect_swapped (menuitem, "activate",
6334                                 G_CALLBACK (gtk_label_select_all), label);
6335       gtk_widget_show (menuitem);
6336       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6337     }
6338
6339   g_signal_emit (label, signals[POPULATE_POPUP], 0, menu);
6340
6341   if (event)
6342     gtk_menu_popup (GTK_MENU (menu), NULL, NULL,
6343                     NULL, NULL,
6344                     event->button, event->time);
6345   else
6346     {
6347       gtk_menu_popup (GTK_MENU (menu), NULL, NULL,
6348                       popup_position_func, label,
6349                       0, gtk_get_current_event_time ());
6350       gtk_menu_shell_select_first (GTK_MENU_SHELL (menu), FALSE);
6351     }
6352 }
6353
6354 static void
6355 gtk_label_clear_links (GtkLabel *label)
6356 {
6357   GtkLabelPrivate *priv = label->priv;
6358
6359   if (!priv->select_info)
6360     return;
6361
6362   g_list_foreach (priv->select_info->links, (GFunc)link_free, NULL);
6363   g_list_free (priv->select_info->links);
6364   priv->select_info->links = NULL;
6365   priv->select_info->active_link = NULL;
6366 }
6367
6368 static void
6369 gtk_label_rescan_links (GtkLabel *label)
6370 {
6371   GtkLabelPrivate *priv = label->priv;
6372   PangoLayout *layout = priv->layout;
6373   PangoAttrList *attlist;
6374   PangoAttrIterator *iter;
6375   GList *links;
6376
6377   if (!priv->select_info || !priv->select_info->links)
6378     return;
6379
6380   attlist = pango_layout_get_attributes (layout);
6381
6382   if (attlist == NULL)
6383     return;
6384
6385   iter = pango_attr_list_get_iterator (attlist);
6386
6387   links = priv->select_info->links;
6388
6389   do
6390     {
6391       PangoAttribute *underline;
6392       PangoAttribute *color;
6393
6394       underline = pango_attr_iterator_get (iter, PANGO_ATTR_UNDERLINE);
6395       color = pango_attr_iterator_get (iter, PANGO_ATTR_FOREGROUND);
6396
6397       if (underline != NULL && color != NULL)
6398         {
6399           gint start, end;
6400           PangoRectangle start_pos;
6401           PangoRectangle end_pos;
6402           GtkLabelLink *link;
6403
6404           pango_attr_iterator_range (iter, &start, &end);
6405           pango_layout_index_to_pos (layout, start, &start_pos);
6406           pango_layout_index_to_pos (layout, end, &end_pos);
6407
6408           if (links == NULL)
6409             {
6410               g_warning ("Ran out of links");
6411               break;
6412             }
6413           link = links->data;
6414           links = links->next;
6415           link->start = start;
6416           link->end = end;
6417         }
6418       } while (pango_attr_iterator_next (iter));
6419
6420     pango_attr_iterator_destroy (iter);
6421 }
6422
6423 static gboolean
6424 gtk_label_activate_link (GtkLabel    *label,
6425                          const gchar *uri)
6426 {
6427   GtkWidget *widget = GTK_WIDGET (label);
6428   GError *error = NULL;
6429
6430   if (!gtk_show_uri (gtk_widget_get_screen (widget),
6431                      uri, gtk_get_current_event_time (), &error))
6432     {
6433       g_warning ("Unable to show '%s': %s", uri, error->message);
6434       g_error_free (error);
6435     }
6436
6437   return TRUE;
6438 }
6439
6440 static void
6441 emit_activate_link (GtkLabel     *label,
6442                     GtkLabelLink *link)
6443 {
6444   GtkLabelPrivate *priv = label->priv;
6445   gboolean handled;
6446
6447   g_signal_emit (label, signals[ACTIVATE_LINK], 0, link->uri, &handled);
6448   if (handled && priv->track_links && !link->visited)
6449     {
6450       link->visited = TRUE;
6451       /* FIXME: shouldn't have to redo everything here */
6452       gtk_label_recalculate (label);
6453     }
6454 }
6455
6456 static void
6457 gtk_label_activate_current_link (GtkLabel *label)
6458 {
6459   GtkLabelLink *link;
6460   GtkWidget *widget = GTK_WIDGET (label);
6461
6462   link = gtk_label_get_focus_link (label);
6463
6464   if (link)
6465     {
6466       emit_activate_link (label, link);
6467     }
6468   else
6469     {
6470       GtkWidget *toplevel;
6471       GtkWindow *window;
6472       GtkWidget *default_widget, *focus_widget;
6473
6474       toplevel = gtk_widget_get_toplevel (widget);
6475       if (GTK_IS_WINDOW (toplevel))
6476         {
6477           window = GTK_WINDOW (toplevel);
6478
6479           if (window)
6480             {
6481               default_widget = gtk_window_get_default_widget (window);
6482               focus_widget = gtk_window_get_focus (window);
6483
6484               if (default_widget != widget &&
6485                   !(widget == focus_widget && (!default_widget || !gtk_widget_is_sensitive (default_widget))))
6486                 gtk_window_activate_default (window);
6487             }
6488         }
6489     }
6490 }
6491
6492 static GtkLabelLink *
6493 gtk_label_get_current_link (GtkLabel *label)
6494 {
6495   GtkLabelPrivate *priv = label->priv;
6496   GtkLabelLink *link;
6497
6498   if (!priv->select_info)
6499     return NULL;
6500
6501   if (priv->select_info->link_clicked)
6502     link = priv->select_info->active_link;
6503   else
6504     link = gtk_label_get_focus_link (label);
6505
6506   return link;
6507 }
6508
6509 /**
6510  * gtk_label_get_current_uri:
6511  * @label: a #GtkLabel
6512  *
6513  * Returns the URI for the currently active link in the label.
6514  * The active link is the one under the mouse pointer or, in a
6515  * selectable label, the link in which the text cursor is currently
6516  * positioned.
6517  *
6518  * This function is intended for use in a #GtkLabel::activate-link handler
6519  * or for use in a #GtkWidget::query-tooltip handler.
6520  *
6521  * Returns: the currently active URI. The string is owned by GTK+ and must
6522  *   not be freed or modified.
6523  *
6524  * Since: 2.18
6525  */
6526 G_CONST_RETURN gchar *
6527 gtk_label_get_current_uri (GtkLabel *label)
6528 {
6529   GtkLabelLink *link;
6530
6531   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
6532
6533   link = gtk_label_get_current_link (label);
6534
6535   if (link)
6536     return link->uri;
6537
6538   return NULL;
6539 }
6540
6541 /**
6542  * gtk_label_set_track_visited_links:
6543  * @label: a #GtkLabel
6544  * @track_links: %TRUE to track visited links
6545  *
6546  * Sets whether the label should keep track of clicked
6547  * links (and use a different color for them).
6548  *
6549  * Since: 2.18
6550  */
6551 void
6552 gtk_label_set_track_visited_links (GtkLabel *label,
6553                                    gboolean  track_links)
6554 {
6555   GtkLabelPrivate *priv;
6556
6557   g_return_if_fail (GTK_IS_LABEL (label));
6558
6559   priv = label->priv;
6560
6561   track_links = track_links != FALSE;
6562
6563   if (priv->track_links != track_links)
6564     {
6565       priv->track_links = track_links;
6566
6567       /* FIXME: shouldn't have to redo everything here */
6568       gtk_label_recalculate (label);
6569
6570       g_object_notify (G_OBJECT (label), "track-visited-links");
6571     }
6572 }
6573
6574 /**
6575  * gtk_label_get_track_visited_links:
6576  * @label: a #GtkLabel
6577  *
6578  * Returns whether the label is currently keeping track
6579  * of clicked links.
6580  *
6581  * Returns: %TRUE if clicked links are remembered
6582  *
6583  * Since: 2.18
6584  */
6585 gboolean
6586 gtk_label_get_track_visited_links (GtkLabel *label)
6587 {
6588   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
6589
6590   return label->priv->track_links;
6591 }
6592
6593 static gboolean
6594 gtk_label_query_tooltip (GtkWidget  *widget,
6595                          gint        x,
6596                          gint        y,
6597                          gboolean    keyboard_tip,
6598                          GtkTooltip *tooltip)
6599 {
6600   GtkLabel *label = GTK_LABEL (widget);
6601   GtkLabelPrivate *priv = label->priv;
6602   GtkLabelSelectionInfo *info = priv->select_info;
6603   gint index = -1;
6604   GList *l;
6605
6606   if (info && info->links)
6607     {
6608       if (keyboard_tip)
6609         {
6610           if (info->selection_anchor == info->selection_end)
6611             index = info->selection_anchor;
6612         }
6613       else
6614         {
6615           if (!get_layout_index (label, x, y, &index))
6616             index = -1;
6617         }
6618
6619       if (index != -1)
6620         {
6621           for (l = info->links; l != NULL; l = l->next)
6622             {
6623               GtkLabelLink *link = l->data;
6624               if (index >= link->start && index <= link->end)
6625                 {
6626                   if (link->title)
6627                     {
6628                       gtk_tooltip_set_markup (tooltip, link->title);
6629                       return TRUE;
6630                     }
6631                   break;
6632                 }
6633             }
6634         }
6635     }
6636
6637   return GTK_WIDGET_CLASS (gtk_label_parent_class)->query_tooltip (widget,
6638                                                                    x, y,
6639                                                                    keyboard_tip,
6640                                                                    tooltip);
6641 }