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