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 static PangoFontMetrics *
3140 get_font_metrics (PangoContext *context, GtkWidget *widget)
3141 {
3142   GtkStyleContext *style_context;
3143   const PangoFontDescription *font;
3144   PangoFontMetrics *retval;
3145
3146   style_context = gtk_widget_get_style_context (widget);
3147   font = gtk_style_context_get_font (style_context, GTK_STATE_FLAG_NORMAL);
3148
3149   retval = pango_context_get_metrics (context,
3150                                       font,
3151                                       pango_context_get_language (context));
3152
3153   return retval;
3154 }
3155
3156 /**
3157  * gtk_label_get_measuring_layout:
3158  * @label: the label
3159  * @existing_layout: %NULL or an existing layout already in use.
3160  * @width: the width to measure with in pango units, or -1 for infinite
3161  *
3162  * Gets a layout that can be used for measuring sizes. The returned
3163  * layout will be identical to the label's layout except for the
3164  * layout's width, which will be set to @width. Do not modify the returned
3165  * layout.
3166  *
3167  * Returns: a new reference to a pango layout
3168  **/
3169 static PangoLayout *
3170 gtk_label_get_measuring_layout (GtkLabel *   label,
3171                                 PangoLayout *existing_layout,
3172                                 int          width)
3173 {
3174   GtkLabelPrivate *priv = label->priv;
3175   PangoRectangle rect;
3176   PangoLayout *copy;
3177
3178   if (existing_layout != NULL)
3179     {
3180       if (existing_layout != priv->layout)
3181         {
3182           pango_layout_set_width (existing_layout, width);
3183           return existing_layout;
3184         }
3185
3186       g_object_unref (existing_layout);
3187     }
3188
3189   gtk_label_ensure_layout (label);
3190
3191   if (pango_layout_get_width (priv->layout) == width)
3192     {
3193       g_object_ref (priv->layout);
3194       return priv->layout;
3195     }
3196
3197   /* We can use the label's own layout if we're not allocated a size yet,
3198    * because we don't need it to be properly setup at that point.
3199    * This way we can make use of caching upon the label's creation.
3200    */
3201   if (gtk_widget_get_allocated_width (GTK_WIDGET (label)) <= 1)
3202     {
3203       g_object_ref (priv->layout);
3204       pango_layout_set_width (priv->layout, width);
3205       return priv->layout;
3206     }
3207
3208   /* oftentimes we want to measure a width that is far wider than the current width,
3209    * even though the layout would not change if we made it wider. In that case, we
3210    * can just return the current layout, because for measuring purposes, it will be
3211    * identical.
3212    */
3213   pango_layout_get_extents (priv->layout, NULL, &rect);
3214   if ((width == -1 || rect.width <= width) &&
3215       !pango_layout_is_wrapped (priv->layout) &&
3216       !pango_layout_is_ellipsized (priv->layout))
3217     {
3218       g_object_ref (priv->layout);
3219       return priv->layout;
3220     }
3221
3222   copy = pango_layout_copy (priv->layout);
3223   pango_layout_set_width (copy, width);
3224   return copy;
3225 }
3226
3227 static void
3228 gtk_label_update_layout_width (GtkLabel *label)
3229 {
3230   GtkLabelPrivate *priv = label->priv;
3231   GtkWidget *widget = GTK_WIDGET (label);
3232
3233   g_assert (priv->layout);
3234
3235   if (priv->ellipsize || priv->wrap)
3236     {
3237       GtkBorder border;
3238       PangoRectangle logical;
3239       gint width, height;
3240
3241       _gtk_misc_get_padding_and_border (GTK_MISC (label), &border);
3242
3243       width = gtk_widget_get_allocated_width (GTK_WIDGET (label)) - border.left - border.right;
3244       height = gtk_widget_get_allocated_height (GTK_WIDGET (label)) - border.top - border.bottom;
3245
3246       if (priv->have_transform)
3247         {
3248           PangoContext *context = gtk_widget_get_pango_context (widget);
3249           const PangoMatrix *matrix = pango_context_get_matrix (context);
3250           const gdouble dx = matrix->xx; /* cos (M_PI * angle / 180) */
3251           const gdouble dy = matrix->xy; /* sin (M_PI * angle / 180) */
3252
3253           pango_layout_set_width (priv->layout, -1);
3254           pango_layout_get_pixel_extents (priv->layout, NULL, &logical);
3255
3256           if (fabs (dy) < 0.01)
3257             {
3258               if (logical.width > width)
3259                 pango_layout_set_width (priv->layout, width * PANGO_SCALE);
3260             }
3261           else if (fabs (dx) < 0.01)
3262             {
3263               if (logical.width > height)
3264                 pango_layout_set_width (priv->layout, height * PANGO_SCALE);
3265             }
3266           else
3267             {
3268               gdouble x0, y0, x1, y1, length;
3269               gboolean vertical;
3270               gint cy;
3271
3272               x0 = width / 2;
3273               y0 = dx ? x0 * dy / dx : G_MAXDOUBLE;
3274               vertical = fabs (y0) > height / 2;
3275
3276               if (vertical)
3277                 {
3278                   y0 = height/2;
3279                   x0 = dy ? y0 * dx / dy : G_MAXDOUBLE;
3280                 }
3281
3282               length = 2 * sqrt (x0 * x0 + y0 * y0);
3283               pango_layout_set_width (priv->layout, rint (length * PANGO_SCALE));
3284               pango_layout_get_pixel_size (priv->layout, NULL, &cy);
3285
3286               x1 = +dy * cy/2;
3287               y1 = -dx * cy/2;
3288
3289               if (vertical)
3290                 {
3291                   y0 = height/2 + y1 - y0;
3292                   x0 = -y0 * dx/dy;
3293                 }
3294               else
3295                 {
3296                   x0 = width/2 + x1 - x0;
3297                   y0 = -x0 * dy/dx;
3298                 }
3299
3300               length = length - sqrt (x0 * x0 + y0 * y0) * 2;
3301               pango_layout_set_width (priv->layout, rint (length * PANGO_SCALE));
3302             }
3303         }
3304       else
3305         {
3306           pango_layout_set_width (priv->layout, width * PANGO_SCALE);
3307         }
3308     }
3309   else
3310     {
3311       pango_layout_set_width (priv->layout, -1);
3312     }
3313 }
3314
3315 static void
3316 gtk_label_ensure_layout (GtkLabel *label)
3317 {
3318   GtkLabelPrivate *priv = label->priv;
3319   GtkWidget *widget;
3320   gboolean rtl;
3321
3322   widget = GTK_WIDGET (label);
3323
3324   rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
3325
3326   if (!priv->layout)
3327     {
3328       PangoAlignment align = PANGO_ALIGN_LEFT; /* Quiet gcc */
3329       PangoAttrList *attrs;
3330       gdouble angle = gtk_label_get_angle (label);
3331
3332       if (angle != 0.0 && !priv->select_info)
3333         {
3334           PangoMatrix matrix = PANGO_MATRIX_INIT;
3335
3336           /* We rotate the standard singleton PangoContext for the widget,
3337            * depending on the fact that it's meant pretty much exclusively
3338            * for our use.
3339            */
3340           pango_matrix_rotate (&matrix, angle);
3341
3342           pango_context_set_matrix (gtk_widget_get_pango_context (widget), &matrix);
3343
3344           priv->have_transform = TRUE;
3345         }
3346       else
3347         {
3348           if (priv->have_transform)
3349             pango_context_set_matrix (gtk_widget_get_pango_context (widget), NULL);
3350
3351           priv->have_transform = FALSE;
3352         }
3353
3354       priv->layout = gtk_widget_create_pango_layout (widget, priv->text);
3355
3356       if (priv->select_info && priv->select_info->links)
3357         {
3358           GdkColor link_color, visited_color;
3359           PangoAttribute *attribute;
3360           GList *list;
3361
3362           gtk_label_get_link_colors (widget, &link_color, &visited_color);
3363           attrs = pango_attr_list_new ();
3364
3365           for (list = priv->select_info->links; list; list = list->next)
3366             {
3367               GtkLabelLink *link = list->data;
3368
3369               attribute = pango_attr_underline_new (TRUE);
3370               attribute->start_index = link->start;
3371               attribute->end_index = link->end;
3372               pango_attr_list_insert (attrs, attribute);
3373
3374               if (link->visited)
3375                 attribute = pango_attr_foreground_new (visited_color.red,
3376                                                        visited_color.green,
3377                                                        visited_color.blue);
3378               else
3379                 attribute = pango_attr_foreground_new (link_color.red,
3380                                                        link_color.green,
3381                                                        link_color.blue);
3382               attribute->start_index = link->start;
3383               attribute->end_index = link->end;
3384               pango_attr_list_insert (attrs, attribute);
3385             }
3386         }
3387       else if (priv->markup_attrs && priv->markup_attrs)
3388         attrs = pango_attr_list_new ();
3389       else
3390         attrs = NULL;
3391
3392       if (priv->markup_attrs)
3393         {
3394           if (attrs)
3395             my_pango_attr_list_merge (attrs, priv->markup_attrs);
3396           else
3397             attrs = pango_attr_list_ref (priv->markup_attrs);
3398         }
3399
3400       if (priv->attrs)
3401         {
3402           if (attrs)
3403             my_pango_attr_list_merge (attrs, priv->attrs);
3404           else
3405             attrs = pango_attr_list_ref (priv->attrs);
3406         }
3407
3408       if (attrs)
3409         {
3410           pango_layout_set_attributes (priv->layout, attrs);
3411           pango_attr_list_unref (attrs);
3412         }
3413
3414       switch (priv->jtype)
3415         {
3416         case GTK_JUSTIFY_LEFT:
3417           align = rtl ? PANGO_ALIGN_RIGHT : PANGO_ALIGN_LEFT;
3418           break;
3419         case GTK_JUSTIFY_RIGHT:
3420           align = rtl ? PANGO_ALIGN_LEFT : PANGO_ALIGN_RIGHT;
3421           break;
3422         case GTK_JUSTIFY_CENTER:
3423           align = PANGO_ALIGN_CENTER;
3424           break;
3425         case GTK_JUSTIFY_FILL:
3426           align = rtl ? PANGO_ALIGN_RIGHT : PANGO_ALIGN_LEFT;
3427           pango_layout_set_justify (priv->layout, TRUE);
3428           break;
3429         default:
3430           g_assert_not_reached();
3431         }
3432
3433       pango_layout_set_alignment (priv->layout, align);
3434       pango_layout_set_ellipsize (priv->layout, priv->ellipsize);
3435       pango_layout_set_wrap (priv->layout, priv->wrap_mode);
3436       pango_layout_set_single_paragraph_mode (priv->layout, priv->single_line_mode);
3437
3438       gtk_label_update_layout_width (label);
3439     }
3440 }
3441
3442 static gint
3443 get_single_line_height (GtkWidget   *widget,
3444                         PangoLayout *layout)
3445 {
3446   PangoContext *context;
3447   PangoFontMetrics *metrics;
3448   gint ascent, descent;
3449
3450   context = pango_layout_get_context (layout);
3451   metrics = get_font_metrics (context, widget);
3452   ascent = pango_font_metrics_get_ascent (metrics);
3453   descent = pango_font_metrics_get_descent (metrics);
3454   pango_font_metrics_unref (metrics);
3455
3456   return ascent + descent;
3457 }
3458
3459 static GtkSizeRequestMode
3460 gtk_label_get_request_mode (GtkWidget *widget)
3461 {
3462   GtkLabel *label = GTK_LABEL (widget);
3463   gdouble   angle = gtk_label_get_angle (label);
3464
3465   if (label->priv->wrap)
3466     return (angle == 90 || angle == 270) ?
3467       GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT :
3468       GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH;
3469
3470     return GTK_SIZE_REQUEST_CONSTANT_SIZE;
3471 }
3472
3473 static void
3474 get_size_for_allocation (GtkLabel        *label,
3475                          GtkOrientation   orientation,
3476                          gint             allocation,
3477                          gint            *minimum_size,
3478                          gint            *natural_size)
3479 {
3480   PangoLayout *layout;
3481   gint text_height;
3482
3483   layout = gtk_label_get_measuring_layout (label, NULL, allocation * PANGO_SCALE);
3484
3485   pango_layout_get_pixel_size (layout, NULL, &text_height);
3486
3487   if (minimum_size)
3488     *minimum_size = text_height;
3489
3490   if (natural_size)
3491     *natural_size = text_height;
3492
3493   g_object_unref (layout);
3494 }
3495
3496 static gint
3497 get_char_pixels (GtkWidget   *label,
3498                  PangoLayout *layout)
3499 {
3500   PangoContext *context;
3501   PangoFontMetrics *metrics;
3502   gint char_width, digit_width;
3503
3504   context = pango_layout_get_context (layout);
3505   metrics = get_font_metrics (context, GTK_WIDGET (label));
3506   char_width = pango_font_metrics_get_approximate_char_width (metrics);
3507   digit_width = pango_font_metrics_get_approximate_digit_width (metrics);
3508   pango_font_metrics_unref (metrics);
3509
3510   return MAX (char_width, digit_width);;
3511 }
3512
3513 static void
3514 gtk_label_get_preferred_layout_size (GtkLabel *label,
3515                                      PangoRectangle *required,
3516                                      PangoRectangle *natural)
3517 {
3518   GtkLabelPrivate *priv = label->priv;
3519   PangoLayout *layout;
3520
3521   /* "width-chars" Hard-coded minimum width:
3522    *    - minimum size should be MAX (width-chars, strlen ("..."));
3523    *    - natural size should be MAX (width-chars, strlen (priv->text));
3524    *
3525    * "max-width-chars" User specified maximum size requisition
3526    *    - minimum size should be MAX (width-chars, 0)
3527    *    - natural size should be MIN (max-width-chars, strlen (priv->text))
3528    *
3529    *    For ellipsizing labels; if max-width-chars is specified: either it is used as
3530    *    a minimum size or the label text as a minimum size (natural size still overflows).
3531    *
3532    *    For wrapping labels; A reasonable minimum size is useful to naturally layout
3533    *    interfaces automatically. In this case if no "width-chars" is specified, the minimum
3534    *    width will default to the wrap guess that gtk_label_ensure_layout() does.
3535    */
3536
3537   /* Start off with the pixel extents of an as-wide-as-possible layout */
3538   layout = gtk_label_get_measuring_layout (label, NULL, -1);
3539
3540   pango_layout_get_extents (layout, NULL, natural);
3541   natural->x = natural->y = 0;
3542
3543   if (priv->wrap)
3544     natural->height = get_single_line_height (GTK_WIDGET (label), layout);
3545
3546   if (priv->ellipsize || priv->wrap)
3547     {
3548       /* a layout with width 0 will be as small as humanly possible */
3549       layout = gtk_label_get_measuring_layout (label, layout, 0);
3550
3551       pango_layout_get_extents (layout, NULL, required);
3552
3553       /* can happen when Pango decides to ellipsize text */
3554       if (required->width > natural->width)
3555         required->width = natural->width;
3556
3557       required->x = required->y = 0;
3558       required->height = natural->height;
3559     }
3560   else
3561     {
3562       *required = *natural;
3563     }
3564
3565   if (priv->width_chars > -1 || priv->max_width_chars > -1)
3566     {
3567       gint char_pixels;
3568
3569       char_pixels = get_char_pixels (GTK_WIDGET (label), layout);
3570
3571       if (priv->width_chars > -1)
3572         required->width = MAX (required->width, char_pixels * priv->width_chars);
3573
3574       if (priv->max_width_chars > -1)
3575         natural->width = MIN (natural->width, priv->max_width_chars * char_pixels);
3576       natural->width = MAX (natural->width, required->width);
3577     }
3578
3579   g_object_unref (layout);
3580 }
3581
3582 static void
3583 gtk_label_get_preferred_size (GtkWidget      *widget,
3584                               GtkOrientation  orientation,
3585                               gint           *minimum_size,
3586                               gint           *natural_size)
3587 {
3588   GtkLabel      *label = GTK_LABEL (widget);
3589   GtkLabelPrivate  *priv = label->priv;
3590   PangoRectangle required_rect;
3591   PangoRectangle natural_rect;
3592   GtkBorder border;
3593
3594   gtk_label_get_preferred_layout_size (label, &required_rect, &natural_rect);
3595
3596   /* Now that we have minimum and natural sizes in pango extents, apply a possible transform */
3597   if (priv->have_transform)
3598     {
3599       PangoLayout *copy;
3600       PangoContext *context;
3601       const PangoMatrix *matrix;
3602
3603       copy = pango_layout_copy (priv->layout);
3604       context = pango_layout_get_context (copy);
3605       matrix = pango_context_get_matrix (context);
3606
3607       pango_layout_set_width (copy, -1);
3608       pango_layout_set_ellipsize (copy, PANGO_ELLIPSIZE_NONE);
3609
3610       pango_layout_get_extents (copy, NULL, &natural_rect);
3611       g_object_unref (copy);
3612
3613       pango_matrix_transform_rectangle (matrix, &required_rect);
3614       pango_matrix_transform_rectangle (matrix, &natural_rect);
3615
3616       /* Bump the natural size in case of ellipsize to ensure pango has
3617        * enough space in the angles (note, we could alternatively set the
3618        * layout to not ellipsize when we know we have been allocated our
3619        * full natural size, or it may be that pango needs a fix here).
3620        */
3621       if (priv->ellipsize && priv->angle != 0 && priv->angle != 90 &&
3622           priv->angle != 180 && priv->angle != 270 && priv->angle != 360)
3623         {
3624           /* For some reason we only need this at about 110 degrees, and only
3625            * when gaining in height
3626            */
3627           natural_rect.height += ROTATION_ELLIPSIZE_PADDING * 2 * PANGO_SCALE;
3628           natural_rect.width  += ROTATION_ELLIPSIZE_PADDING * 2 * PANGO_SCALE;
3629         }
3630     }
3631
3632   required_rect.width  = PANGO_PIXELS_CEIL (required_rect.width);
3633   required_rect.height = PANGO_PIXELS_CEIL (required_rect.height);
3634
3635   natural_rect.width  = PANGO_PIXELS_CEIL (natural_rect.width);
3636   natural_rect.height = PANGO_PIXELS_CEIL (natural_rect.height);
3637
3638   _gtk_misc_get_padding_and_border (GTK_MISC (label), &border);
3639
3640   if (orientation == GTK_ORIENTATION_HORIZONTAL)
3641     {
3642       /* Note, we cant use get_size_for_allocation() when rotating
3643        * ellipsized labels.
3644        */
3645       if (!(priv->ellipsize && priv->have_transform) &&
3646           (priv->angle == 90 || priv->angle == 270))
3647         {
3648           /* Doing a h4w request on a rotated label here, return the
3649            * required width for the minimum height.
3650            */
3651           get_size_for_allocation (label,
3652                                    GTK_ORIENTATION_VERTICAL,
3653                                    required_rect.height,
3654                                    minimum_size, natural_size);
3655
3656         }
3657       else
3658         {
3659           /* Normal desired width */
3660           *minimum_size = required_rect.width;
3661           *natural_size = natural_rect.width;
3662         }
3663
3664       *minimum_size += border.left + border.right;
3665       *natural_size += border.left + border.right;
3666     }
3667   else /* GTK_ORIENTATION_VERTICAL */
3668     {
3669       /* Note, we cant use get_size_for_allocation() when rotating
3670        * ellipsized labels.
3671        */
3672       if (!(priv->ellipsize && priv->have_transform) &&
3673           (priv->angle == 0 || priv->angle == 180 || priv->angle == 360))
3674         {
3675           /* Doing a w4h request on a label here, return the required
3676            * height for the minimum width.
3677            */
3678           get_size_for_allocation (label,
3679                                    GTK_ORIENTATION_HORIZONTAL,
3680                                    required_rect.width,
3681                                    minimum_size, natural_size);
3682         }
3683       else
3684         {
3685           /* A vertically rotated label does w4h, so return the base
3686            * desired height (text length)
3687            */
3688           *minimum_size = required_rect.height;
3689           *natural_size = natural_rect.height;
3690         }
3691
3692       *minimum_size += border.top + border.bottom;
3693       *natural_size += border.top + border.bottom;
3694     }
3695 }
3696
3697 static void
3698 gtk_label_get_preferred_width (GtkWidget *widget,
3699                                gint      *minimum_size,
3700                                gint      *natural_size)
3701 {
3702   gtk_label_get_preferred_size (widget, GTK_ORIENTATION_HORIZONTAL, minimum_size, natural_size);
3703 }
3704
3705 static void
3706 gtk_label_get_preferred_height (GtkWidget *widget,
3707                                 gint      *minimum_size,
3708                                 gint      *natural_size)
3709 {
3710   gtk_label_get_preferred_size (widget, GTK_ORIENTATION_VERTICAL, minimum_size, natural_size);
3711 }
3712
3713 static void
3714 gtk_label_get_preferred_width_for_height (GtkWidget *widget,
3715                                           gint       height,
3716                                           gint      *minimum_width,
3717                                           gint      *natural_width)
3718 {
3719   GtkLabel *label = GTK_LABEL (widget);
3720   GtkLabelPrivate *priv = label->priv;
3721
3722   if (priv->wrap && (priv->angle == 90 || priv->angle == 270))
3723     {
3724       GtkBorder border;
3725
3726       _gtk_misc_get_padding_and_border (GTK_MISC (label), &border);
3727
3728       if (priv->wrap)
3729         gtk_label_clear_layout (label);
3730
3731       get_size_for_allocation (label, GTK_ORIENTATION_VERTICAL,
3732                                MAX (1, height - border.top - border.bottom),
3733                                minimum_width, natural_width);
3734
3735       if (minimum_width)
3736         *minimum_width += border.right + border.left;
3737
3738       if (natural_width)
3739         *natural_width += border.right + border.left;
3740     }
3741   else
3742     GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, minimum_width, natural_width);
3743 }
3744
3745 static void
3746 gtk_label_get_preferred_height_for_width (GtkWidget *widget,
3747                                           gint       width,
3748                                           gint      *minimum_height,
3749                                           gint      *natural_height)
3750 {
3751   GtkLabel *label = GTK_LABEL (widget);
3752   GtkLabelPrivate *priv = label->priv;
3753
3754   if (priv->wrap && (priv->angle == 0 || priv->angle == 180 || priv->angle == 360))
3755     {
3756       GtkBorder border;
3757
3758       _gtk_misc_get_padding_and_border (GTK_MISC (label), &border);
3759
3760       if (priv->wrap)
3761         gtk_label_clear_layout (label);
3762
3763       get_size_for_allocation (label, GTK_ORIENTATION_HORIZONTAL,
3764                                MAX (1, width - border.left - border.right),
3765                                minimum_height, natural_height);
3766
3767       if (minimum_height)
3768         *minimum_height += border.top + border.bottom;
3769
3770       if (natural_height)
3771         *natural_height += border.top + border.bottom;
3772     }
3773   else
3774     GTK_WIDGET_GET_CLASS (widget)->get_preferred_height (widget, minimum_height, natural_height);
3775 }
3776
3777 static void
3778 gtk_label_size_allocate (GtkWidget     *widget,
3779                          GtkAllocation *allocation)
3780 {
3781   GtkLabel *label = GTK_LABEL (widget);
3782   GtkLabelPrivate *priv = label->priv;
3783
3784   GTK_WIDGET_CLASS (gtk_label_parent_class)->size_allocate (widget, allocation);
3785
3786   if (priv->layout)
3787     gtk_label_update_layout_width (label);
3788
3789   if (priv->select_info && priv->select_info->window)
3790     {
3791       gdk_window_move_resize (priv->select_info->window,
3792                               allocation->x,
3793                               allocation->y,
3794                               allocation->width,
3795                               allocation->height);
3796     }
3797 }
3798
3799 static void
3800 gtk_label_update_cursor (GtkLabel *label)
3801 {
3802   GtkLabelPrivate *priv = label->priv;
3803   GtkWidget *widget;
3804
3805   if (!priv->select_info)
3806     return;
3807
3808   widget = GTK_WIDGET (label);
3809
3810   if (gtk_widget_get_realized (widget))
3811     {
3812       GdkDisplay *display;
3813       GdkCursor *cursor;
3814
3815       if (gtk_widget_is_sensitive (widget))
3816         {
3817           display = gtk_widget_get_display (widget);
3818
3819           if (priv->select_info->active_link)
3820             cursor = gdk_cursor_new_for_display (display, GDK_HAND2);
3821           else if (priv->select_info->selectable)
3822             cursor = gdk_cursor_new_for_display (display, GDK_XTERM);
3823           else
3824             cursor = NULL;
3825         }
3826       else
3827         cursor = NULL;
3828
3829       gdk_window_set_cursor (priv->select_info->window, cursor);
3830
3831       if (cursor)
3832         g_object_unref (cursor);
3833     }
3834 }
3835
3836 static void
3837 gtk_label_state_flags_changed (GtkWidget     *widget,
3838                                GtkStateFlags  prev_state)
3839 {
3840   GtkLabel *label = GTK_LABEL (widget);
3841   GtkLabelPrivate *priv = label->priv;
3842
3843   if (priv->select_info)
3844     {
3845       if (!gtk_widget_is_sensitive (widget))
3846         gtk_label_select_region (label, 0, 0);
3847
3848       gtk_label_update_cursor (label);
3849     }
3850
3851   /* We have to clear the layout, fonts etc. may have changed */
3852   gtk_label_clear_layout (label);
3853
3854   if (GTK_WIDGET_CLASS (gtk_label_parent_class)->state_flags_changed)
3855     GTK_WIDGET_CLASS (gtk_label_parent_class)->state_flags_changed (widget, prev_state);
3856 }
3857
3858 static void
3859 gtk_label_style_updated (GtkWidget *widget)
3860 {
3861   GtkLabel *label = GTK_LABEL (widget);
3862
3863   GTK_WIDGET_CLASS (gtk_label_parent_class)->style_updated (widget);
3864
3865   /* We have to clear the layout, fonts etc. may have changed */
3866   gtk_label_clear_layout (label);
3867 }
3868
3869 static void
3870 gtk_label_direction_changed (GtkWidget        *widget,
3871                              GtkTextDirection previous_dir)
3872 {
3873   GtkLabel *label = GTK_LABEL (widget);
3874   GtkLabelPrivate *priv = label->priv;
3875
3876   if (priv->layout)
3877     pango_layout_context_changed (priv->layout);
3878
3879   GTK_WIDGET_CLASS (gtk_label_parent_class)->direction_changed (widget, previous_dir);
3880 }
3881
3882 static void
3883 get_layout_location (GtkLabel  *label,
3884                      gint      *xp,
3885                      gint      *yp)
3886 {
3887   GtkAllocation allocation;
3888   GtkMisc *misc;
3889   GtkWidget *widget;
3890   GtkLabelPrivate *priv;
3891   GtkBorder border;
3892   gint req_width, x, y;
3893   gint req_height;
3894   gfloat xalign, yalign;
3895   PangoRectangle logical;
3896
3897   misc   = GTK_MISC (label);
3898   widget = GTK_WIDGET (label);
3899   priv   = label->priv;
3900
3901   gtk_misc_get_alignment (misc, &xalign, &yalign);
3902   _gtk_misc_get_padding_and_border (GTK_MISC (label), &border);
3903
3904   if (gtk_widget_get_direction (widget) != GTK_TEXT_DIR_LTR)
3905     xalign = 1.0 - xalign;
3906
3907   pango_layout_get_extents (priv->layout, NULL, &logical);
3908
3909   if (priv->have_transform)
3910     {
3911       PangoContext *context = gtk_widget_get_pango_context (widget);
3912       const PangoMatrix *matrix = pango_context_get_matrix (context);
3913       pango_matrix_transform_rectangle (matrix, &logical);
3914     }
3915
3916   pango_extents_to_pixels (&logical, NULL);
3917
3918   req_width  = logical.width;
3919   req_height = logical.height;
3920
3921   req_width  += border.left + border.right;
3922   req_height += border.top + border.bottom;
3923
3924   gtk_widget_get_allocation (widget, &allocation);
3925
3926   x = floor (allocation.x + border.left + xalign * (allocation.width - req_width) - logical.x);
3927
3928   /* bgo#315462 - For single-line labels, *do* align the requisition with
3929    * respect to the allocation, even if we are under-allocated.  For multi-line
3930    * labels, always show the top of the text when they are under-allocated.  The
3931    * rationale is this:
3932    *
3933    * - Single-line labels appear in GtkButtons, and it is very easy to get them
3934    *   to be smaller than their requisition.  The button may clip the label, but
3935    *   the label will still be able to show most of itself and the focus
3936    *   rectangle.  Also, it is fairly easy to read a single line of clipped text.
3937    *
3938    * - Multi-line labels should not be clipped to showing "something in the
3939    *   middle".  You want to read the first line, at least, to get some context.
3940    */
3941   if (pango_layout_get_line_count (priv->layout) == 1)
3942     y = floor (allocation.y + border.top + (allocation.height - req_height) * yalign) - logical.y;
3943   else
3944     y = floor (allocation.y + border.top + MAX ((allocation.height - req_height) * yalign, 0)) - logical.y;
3945
3946   if (xp)
3947     *xp = x;
3948
3949   if (yp)
3950     *yp = y;
3951 }
3952
3953 static PangoDirection
3954 get_cursor_direction (GtkLabel *label)
3955 {
3956   GtkLabelPrivate *priv = label->priv;
3957   GSList *l;
3958
3959   g_assert (priv->select_info);
3960
3961   gtk_label_ensure_layout (label);
3962
3963   for (l = pango_layout_get_lines_readonly (priv->layout); l; l = l->next)
3964     {
3965       PangoLayoutLine *line = l->data;
3966
3967       /* If priv->select_info->selection_end is at the very end of
3968        * the line, we don't know if the cursor is on this line or
3969        * the next without looking ahead at the next line. (End
3970        * of paragraph is different from line break.) But it's
3971        * definitely in this paragraph, which is good enough
3972        * to figure out the resolved direction.
3973        */
3974        if (line->start_index + line->length >= priv->select_info->selection_end)
3975         return line->resolved_dir;
3976     }
3977
3978   return PANGO_DIRECTION_LTR;
3979 }
3980
3981 static GtkLabelLink *
3982 gtk_label_get_focus_link (GtkLabel *label)
3983 {
3984   GtkLabelPrivate *priv = label->priv;
3985   GtkLabelSelectionInfo *info = priv->select_info;
3986   GList *l;
3987
3988   if (!info)
3989     return NULL;
3990
3991   if (info->selection_anchor != info->selection_end)
3992     return NULL;
3993
3994   for (l = info->links; l; l = l->next)
3995     {
3996       GtkLabelLink *link = l->data;
3997       if (link->start <= info->selection_anchor &&
3998           info->selection_anchor <= link->end)
3999         return link;
4000     }
4001
4002   return NULL;
4003 }
4004
4005 static gint
4006 gtk_label_draw (GtkWidget *widget,
4007                 cairo_t   *cr)
4008 {
4009   GtkLabel *label = GTK_LABEL (widget);
4010   GtkLabelPrivate *priv = label->priv;
4011   GtkLabelSelectionInfo *info = priv->select_info;
4012   GtkAllocation allocation;
4013   GtkStyleContext *context;
4014   GtkStateFlags state;
4015   gint x, y;
4016
4017   gtk_label_ensure_layout (label);
4018
4019   context = gtk_widget_get_style_context (widget);
4020   gtk_widget_get_allocation (widget, &allocation);
4021
4022   gtk_render_background (context, cr,
4023                          0, 0,
4024                          allocation.width, allocation.height);
4025   gtk_render_frame (context, cr,
4026                     0, 0,
4027                     allocation.width, allocation.height);
4028
4029   if (priv->text && (*priv->text != '\0'))
4030     {
4031       get_layout_location (label, &x, &y);
4032
4033       cairo_translate (cr, -allocation.x, -allocation.y);
4034
4035       gtk_render_layout (context, cr,
4036                          x, y,
4037                          priv->layout);
4038
4039       state = gtk_widget_get_state_flags (widget);
4040
4041       if (info &&
4042           (info->selection_anchor != info->selection_end))
4043         {
4044           gint range[2];
4045           cairo_region_t *clip;
4046           GdkRGBA bg_color, fg_color;
4047
4048           range[0] = info->selection_anchor;
4049           range[1] = info->selection_end;
4050
4051           if (range[0] > range[1])
4052             {
4053               gint tmp = range[0];
4054               range[0] = range[1];
4055               range[1] = tmp;
4056             }
4057
4058           clip = gdk_pango_layout_get_clip_region (priv->layout,
4059                                                    x, y,
4060                                                    range,
4061                                                    1);
4062
4063          /* FIXME should use gtk_paint, but it can't use a clip region */
4064           cairo_save (cr);
4065
4066           gdk_cairo_region (cr, clip);
4067           cairo_clip (cr);
4068
4069           state |= GTK_STATE_FLAG_SELECTED;
4070
4071           gtk_style_context_get_color (context, state, &fg_color);
4072           gtk_style_context_get_background_color (context, state, &bg_color);
4073
4074           gdk_cairo_set_source_rgba (cr, &bg_color);
4075           cairo_paint (cr);
4076
4077           gdk_cairo_set_source_rgba (cr, &fg_color);
4078           cairo_move_to (cr, x, y);
4079           _gtk_pango_fill_layout (cr, priv->layout);
4080
4081           cairo_restore (cr);
4082           cairo_region_destroy (clip);
4083         }
4084       else if (info)
4085         {
4086           GtkLabelLink *focus_link;
4087           GtkLabelLink *active_link;
4088           gint range[2];
4089           cairo_region_t *clip;
4090           GdkRectangle rect;
4091           GdkColor *text_color;
4092           GdkColor link_color;
4093           GdkColor visited_link_color;
4094
4095           if (info->selectable &&
4096               gtk_widget_has_focus (widget) &&
4097               gtk_widget_is_drawable (widget))
4098             {
4099               PangoDirection cursor_direction;
4100
4101               cursor_direction = get_cursor_direction (label);
4102               gtk_render_insertion_cursor (context, cr,
4103                                            x, y,
4104                                            priv->layout, priv->select_info->selection_end,
4105                                            cursor_direction);
4106             }
4107
4108           focus_link = gtk_label_get_focus_link (label);
4109           active_link = info->active_link;
4110
4111           if (active_link)
4112             {
4113               GdkRGBA bg_color;
4114
4115               range[0] = active_link->start;
4116               range[1] = active_link->end;
4117
4118               cairo_save (cr);
4119
4120               clip = gdk_pango_layout_get_clip_region (priv->layout,
4121                                                        x, y,
4122                                                        range,
4123                                                        1);
4124               gdk_cairo_region (cr, clip);
4125               cairo_clip (cr);
4126               cairo_region_destroy (clip);
4127
4128               gtk_label_get_link_colors (widget, &link_color, &visited_link_color);
4129               if (active_link->visited)
4130                 text_color = &visited_link_color;
4131               else
4132                 text_color = &link_color;
4133
4134               if (info->link_clicked)
4135                 state |= GTK_STATE_FLAG_ACTIVE;
4136               else
4137                 state |= GTK_STATE_FLAG_PRELIGHT;
4138
4139               gtk_style_context_get_background_color (context, state, &bg_color);
4140
4141               gdk_cairo_set_source_rgba (cr, &bg_color);
4142               cairo_paint (cr);
4143
4144               cairo_set_source_rgb (cr, text_color->red / 65535.,
4145                                         text_color->green / 65535.,
4146                                         text_color->blue / 65535.);
4147               cairo_move_to (cr, x, y);
4148               _gtk_pango_fill_layout (cr, priv->layout);
4149
4150               cairo_restore (cr);
4151             }
4152
4153           if (focus_link && gtk_widget_has_visible_focus (widget))
4154             {
4155               range[0] = focus_link->start;
4156               range[1] = focus_link->end;
4157
4158               clip = gdk_pango_layout_get_clip_region (priv->layout,
4159                                                        x, y,
4160                                                        range,
4161                                                        1);
4162               cairo_region_get_extents (clip, &rect);
4163
4164               gtk_render_focus (context, cr,
4165                                 rect.x, rect.y,
4166                                 rect.width, rect.height);
4167
4168               cairo_region_destroy (clip);
4169             }
4170         }
4171     }
4172
4173   return FALSE;
4174 }
4175
4176 static gboolean
4177 separate_uline_pattern (const gchar  *str,
4178                         guint        *accel_key,
4179                         gchar       **new_str,
4180                         gchar       **pattern)
4181 {
4182   gboolean underscore;
4183   const gchar *src;
4184   gchar *dest;
4185   gchar *pattern_dest;
4186
4187   *accel_key = GDK_KEY_VoidSymbol;
4188   *new_str = g_new (gchar, strlen (str) + 1);
4189   *pattern = g_new (gchar, g_utf8_strlen (str, -1) + 1);
4190
4191   underscore = FALSE;
4192
4193   src = str;
4194   dest = *new_str;
4195   pattern_dest = *pattern;
4196
4197   while (*src)
4198     {
4199       gunichar c;
4200       const gchar *next_src;
4201
4202       c = g_utf8_get_char (src);
4203       if (c == (gunichar)-1)
4204         {
4205           g_warning ("Invalid input string");
4206           g_free (*new_str);
4207           g_free (*pattern);
4208
4209           return FALSE;
4210         }
4211       next_src = g_utf8_next_char (src);
4212
4213       if (underscore)
4214         {
4215           if (c == '_')
4216             *pattern_dest++ = ' ';
4217           else
4218             {
4219               *pattern_dest++ = '_';
4220               if (*accel_key == GDK_KEY_VoidSymbol)
4221                 *accel_key = gdk_keyval_to_lower (gdk_unicode_to_keyval (c));
4222             }
4223
4224           while (src < next_src)
4225             *dest++ = *src++;
4226
4227           underscore = FALSE;
4228         }
4229       else
4230         {
4231           if (c == '_')
4232             {
4233               underscore = TRUE;
4234               src = next_src;
4235             }
4236           else
4237             {
4238               while (src < next_src)
4239                 *dest++ = *src++;
4240
4241               *pattern_dest++ = ' ';
4242             }
4243         }
4244     }
4245
4246   *dest = 0;
4247   *pattern_dest = 0;
4248
4249   return TRUE;
4250 }
4251
4252 static void
4253 gtk_label_set_uline_text_internal (GtkLabel    *label,
4254                                    const gchar *str)
4255 {
4256   GtkLabelPrivate *priv = label->priv;
4257   guint accel_key = GDK_KEY_VoidSymbol;
4258   gchar *new_str;
4259   gchar *pattern;
4260
4261   g_return_if_fail (GTK_IS_LABEL (label));
4262   g_return_if_fail (str != NULL);
4263
4264   /* Split text into the base text and a separate pattern
4265    * of underscores.
4266    */
4267   if (!separate_uline_pattern (str, &accel_key, &new_str, &pattern))
4268     return;
4269
4270   gtk_label_set_text_internal (label, new_str);
4271   gtk_label_set_pattern_internal (label, pattern, TRUE);
4272   priv->mnemonic_keyval = accel_key;
4273
4274   g_free (pattern);
4275 }
4276
4277 /**
4278  * gtk_label_set_text_with_mnemonic:
4279  * @label: a #GtkLabel
4280  * @str: a string
4281  *
4282  * Sets the label's text from the string @str.
4283  * If characters in @str are preceded by an underscore, they are underlined
4284  * indicating that they represent a keyboard accelerator called a mnemonic.
4285  * The mnemonic key can be used to activate another widget, chosen
4286  * automatically, or explicitly using gtk_label_set_mnemonic_widget().
4287  **/
4288 void
4289 gtk_label_set_text_with_mnemonic (GtkLabel    *label,
4290                                   const gchar *str)
4291 {
4292   g_return_if_fail (GTK_IS_LABEL (label));
4293   g_return_if_fail (str != NULL);
4294
4295   g_object_freeze_notify (G_OBJECT (label));
4296
4297   gtk_label_set_label_internal (label, g_strdup (str ? str : ""));
4298   gtk_label_set_use_markup_internal (label, FALSE);
4299   gtk_label_set_use_underline_internal (label, TRUE);
4300
4301   gtk_label_recalculate (label);
4302
4303   g_object_thaw_notify (G_OBJECT (label));
4304 }
4305
4306 static void
4307 gtk_label_realize (GtkWidget *widget)
4308 {
4309   GtkLabel *label = GTK_LABEL (widget);
4310   GtkLabelPrivate *priv = label->priv;
4311
4312   GTK_WIDGET_CLASS (gtk_label_parent_class)->realize (widget);
4313
4314   if (priv->select_info)
4315     gtk_label_create_window (label);
4316 }
4317
4318 static void
4319 gtk_label_unrealize (GtkWidget *widget)
4320 {
4321   GtkLabel *label = GTK_LABEL (widget);
4322   GtkLabelPrivate *priv = label->priv;
4323
4324   if (priv->select_info)
4325     gtk_label_destroy_window (label);
4326
4327   GTK_WIDGET_CLASS (gtk_label_parent_class)->unrealize (widget);
4328 }
4329
4330 static void
4331 gtk_label_map (GtkWidget *widget)
4332 {
4333   GtkLabel *label = GTK_LABEL (widget);
4334   GtkLabelPrivate *priv = label->priv;
4335
4336   GTK_WIDGET_CLASS (gtk_label_parent_class)->map (widget);
4337
4338   if (priv->select_info)
4339     gdk_window_show (priv->select_info->window);
4340 }
4341
4342 static void
4343 gtk_label_unmap (GtkWidget *widget)
4344 {
4345   GtkLabel *label = GTK_LABEL (widget);
4346   GtkLabelPrivate *priv = label->priv;
4347
4348   if (priv->select_info)
4349     gdk_window_hide (priv->select_info->window);
4350
4351   GTK_WIDGET_CLASS (gtk_label_parent_class)->unmap (widget);
4352 }
4353
4354 static void
4355 window_to_layout_coords (GtkLabel *label,
4356                          gint     *x,
4357                          gint     *y)
4358 {
4359   GtkAllocation allocation;
4360   gint lx, ly;
4361   GtkWidget *widget;
4362
4363   widget = GTK_WIDGET (label);
4364
4365   /* get layout location in widget->window coords */
4366   get_layout_location (label, &lx, &ly);
4367
4368   gtk_widget_get_allocation (widget, &allocation);
4369
4370   if (x)
4371     {
4372       *x += allocation.x; /* go to widget->window */
4373       *x -= lx;                   /* go to layout */
4374     }
4375
4376   if (y)
4377     {
4378       *y += allocation.y; /* go to widget->window */
4379       *y -= ly;                   /* go to layout */
4380     }
4381 }
4382
4383 #if 0
4384 static void
4385 layout_to_window_coords (GtkLabel *label,
4386                          gint     *x,
4387                          gint     *y)
4388 {
4389   gint lx, ly;
4390   GtkWidget *widget;
4391
4392   widget = GTK_WIDGET (label);
4393
4394   /* get layout location in widget->window coords */
4395   get_layout_location (label, &lx, &ly);
4396
4397   if (x)
4398     {
4399       *x += lx;                   /* go to widget->window */
4400       *x -= widget->allocation.x; /* go to selection window */
4401     }
4402
4403   if (y)
4404     {
4405       *y += ly;                   /* go to widget->window */
4406       *y -= widget->allocation.y; /* go to selection window */
4407     }
4408 }
4409 #endif
4410
4411 static gboolean
4412 get_layout_index (GtkLabel *label,
4413                   gint      x,
4414                   gint      y,
4415                   gint     *index)
4416 {
4417   GtkLabelPrivate *priv = label->priv;
4418   gint trailing = 0;
4419   const gchar *cluster;
4420   const gchar *cluster_end;
4421   gboolean inside;
4422
4423   *index = 0;
4424
4425   gtk_label_ensure_layout (label);
4426
4427   window_to_layout_coords (label, &x, &y);
4428
4429   x *= PANGO_SCALE;
4430   y *= PANGO_SCALE;
4431
4432   inside = pango_layout_xy_to_index (priv->layout,
4433                                      x, y,
4434                                      index, &trailing);
4435
4436   cluster = priv->text + *index;
4437   cluster_end = cluster;
4438   while (trailing)
4439     {
4440       cluster_end = g_utf8_next_char (cluster_end);
4441       --trailing;
4442     }
4443
4444   *index += (cluster_end - cluster);
4445
4446   return inside;
4447 }
4448
4449 static void
4450 gtk_label_select_word (GtkLabel *label)
4451 {
4452   GtkLabelPrivate *priv = label->priv;
4453   gint min, max;
4454
4455   gint start_index = gtk_label_move_backward_word (label, priv->select_info->selection_end);
4456   gint end_index = gtk_label_move_forward_word (label, priv->select_info->selection_end);
4457
4458   min = MIN (priv->select_info->selection_anchor,
4459              priv->select_info->selection_end);
4460   max = MAX (priv->select_info->selection_anchor,
4461              priv->select_info->selection_end);
4462
4463   min = MIN (min, start_index);
4464   max = MAX (max, end_index);
4465
4466   gtk_label_select_region_index (label, min, max);
4467 }
4468
4469 static void
4470 gtk_label_grab_focus (GtkWidget *widget)
4471 {
4472   GtkLabel *label = GTK_LABEL (widget);
4473   GtkLabelPrivate *priv = label->priv;
4474   gboolean select_on_focus;
4475   GtkLabelLink *link;
4476
4477   if (priv->select_info == NULL)
4478     return;
4479
4480   GTK_WIDGET_CLASS (gtk_label_parent_class)->grab_focus (widget);
4481
4482   if (priv->select_info->selectable)
4483     {
4484       g_object_get (gtk_widget_get_settings (widget),
4485                     "gtk-label-select-on-focus",
4486                     &select_on_focus,
4487                     NULL);
4488
4489       if (select_on_focus && !priv->in_click)
4490         gtk_label_select_region (label, 0, -1);
4491     }
4492   else
4493     {
4494       if (priv->select_info->links && !priv->in_click)
4495         {
4496           link = priv->select_info->links->data;
4497           priv->select_info->selection_anchor = link->start;
4498           priv->select_info->selection_end = link->start;
4499         }
4500     }
4501 }
4502
4503 static gboolean
4504 gtk_label_focus (GtkWidget        *widget,
4505                  GtkDirectionType  direction)
4506 {
4507   GtkLabel *label = GTK_LABEL (widget);
4508   GtkLabelPrivate *priv = label->priv;
4509   GtkLabelSelectionInfo *info = priv->select_info;
4510   GtkLabelLink *focus_link;
4511   GList *l;
4512
4513   if (!gtk_widget_is_focus (widget))
4514     {
4515       gtk_widget_grab_focus (widget);
4516       if (info)
4517         {
4518           focus_link = gtk_label_get_focus_link (label);
4519           if (focus_link && direction == GTK_DIR_TAB_BACKWARD)
4520             {
4521               l = g_list_last (info->links);
4522               focus_link = l->data;
4523               info->selection_anchor = focus_link->start;
4524               info->selection_end = focus_link->start;
4525             }
4526         }
4527
4528       return TRUE;
4529     }
4530
4531   if (!info)
4532     return FALSE;
4533
4534   if (info->selectable)
4535     {
4536       gint index;
4537
4538       if (info->selection_anchor != info->selection_end)
4539         goto out;
4540
4541       index = info->selection_anchor;
4542
4543       if (direction == GTK_DIR_TAB_FORWARD)
4544         for (l = info->links; l; l = l->next)
4545           {
4546             GtkLabelLink *link = l->data;
4547
4548             if (link->start > index)
4549               {
4550                 gtk_label_select_region_index (label, link->start, link->start);
4551                 return TRUE;
4552               }
4553           }
4554       else if (direction == GTK_DIR_TAB_BACKWARD)
4555         for (l = g_list_last (info->links); l; l = l->prev)
4556           {
4557             GtkLabelLink *link = l->data;
4558
4559             if (link->end < index)
4560               {
4561                 gtk_label_select_region_index (label, link->start, link->start);
4562                 return TRUE;
4563               }
4564           }
4565
4566       goto out;
4567     }
4568   else
4569     {
4570       focus_link = gtk_label_get_focus_link (label);
4571       switch (direction)
4572         {
4573         case GTK_DIR_TAB_FORWARD:
4574           if (focus_link)
4575             {
4576               l = g_list_find (info->links, focus_link);
4577               l = l->next;
4578             }
4579           else
4580             l = info->links;
4581           break;
4582
4583         case GTK_DIR_TAB_BACKWARD:
4584           if (focus_link)
4585             {
4586               l = g_list_find (info->links, focus_link);
4587               l = l->prev;
4588             }
4589           else
4590             l = g_list_last (info->links);
4591           break;
4592
4593         default:
4594           goto out;
4595         }
4596
4597       if (l)
4598         {
4599           focus_link = l->data;
4600           info->selection_anchor = focus_link->start;
4601           info->selection_end = focus_link->start;
4602           gtk_widget_queue_draw (widget);
4603
4604           return TRUE;
4605         }
4606     }
4607
4608 out:
4609
4610   return FALSE;
4611 }
4612
4613 static gboolean
4614 gtk_label_button_press (GtkWidget      *widget,
4615                         GdkEventButton *event)
4616 {
4617   GtkLabel *label = GTK_LABEL (widget);
4618   GtkLabelPrivate *priv = label->priv;
4619   GtkLabelSelectionInfo *info = priv->select_info;
4620   gint index = 0;
4621   gint min, max;
4622
4623   if (info == NULL)
4624     return FALSE;
4625
4626   if (info->active_link)
4627     {
4628       if (gdk_event_triggers_context_menu ((GdkEvent *) event))
4629         {
4630           info->link_clicked = 1;
4631           gtk_label_do_popup (label, event);
4632           return TRUE;
4633         }
4634       else if (event->button == GDK_BUTTON_PRIMARY)
4635         {
4636           info->link_clicked = 1;
4637           gtk_widget_queue_draw (widget);
4638         }
4639     }
4640
4641   if (!info->selectable)
4642     return FALSE;
4643
4644   info->in_drag = FALSE;
4645   info->select_words = FALSE;
4646
4647   if (gdk_event_triggers_context_menu ((GdkEvent *) event))
4648     {
4649       gtk_label_do_popup (label, event);
4650
4651       return TRUE;
4652     }
4653   else if (event->button == GDK_BUTTON_PRIMARY)
4654     {
4655       if (!gtk_widget_has_focus (widget))
4656         {
4657           priv->in_click = TRUE;
4658           gtk_widget_grab_focus (widget);
4659           priv->in_click = FALSE;
4660         }
4661
4662       if (event->type == GDK_3BUTTON_PRESS)
4663         {
4664           gtk_label_select_region_index (label, 0, strlen (priv->text));
4665           return TRUE;
4666         }
4667
4668       if (event->type == GDK_2BUTTON_PRESS)
4669         {
4670           info->select_words = TRUE;
4671           gtk_label_select_word (label);
4672           return TRUE;
4673         }
4674
4675       get_layout_index (label, event->x, event->y, &index);
4676
4677       min = MIN (info->selection_anchor, info->selection_end);
4678       max = MAX (info->selection_anchor, info->selection_end);
4679
4680       if ((info->selection_anchor != info->selection_end) &&
4681           (event->state & GDK_SHIFT_MASK))
4682         {
4683           if (index > min && index < max)
4684             {
4685               /* truncate selection, but keep it as big as possible */
4686               if (index - min > max - index)
4687                 max = index;
4688               else
4689                 min = index;
4690             }
4691           else
4692             {
4693               /* extend (same as motion) */
4694               min = MIN (min, index);
4695               max = MAX (max, index);
4696             }
4697
4698           /* ensure the anchor is opposite index */
4699           if (index == min)
4700             {
4701               gint tmp = min;
4702               min = max;
4703               max = tmp;
4704             }
4705
4706           gtk_label_select_region_index (label, min, max);
4707         }
4708       else
4709         {
4710           if (event->type == GDK_3BUTTON_PRESS)
4711             gtk_label_select_region_index (label, 0, strlen (priv->text));
4712           else if (event->type == GDK_2BUTTON_PRESS)
4713             gtk_label_select_word (label);
4714           else if (min < max && min <= index && index <= max)
4715             {
4716               info->in_drag = TRUE;
4717               info->drag_start_x = event->x;
4718               info->drag_start_y = event->y;
4719             }
4720           else
4721             /* start a replacement */
4722             gtk_label_select_region_index (label, index, index);
4723         }
4724
4725       return TRUE;
4726     }
4727
4728   return FALSE;
4729 }
4730
4731 static gboolean
4732 gtk_label_button_release (GtkWidget      *widget,
4733                           GdkEventButton *event)
4734
4735 {
4736   GtkLabel *label = GTK_LABEL (widget);
4737   GtkLabelPrivate *priv = label->priv;
4738   GtkLabelSelectionInfo *info = priv->select_info;
4739   gint index;
4740
4741   if (info == NULL)
4742     return FALSE;
4743
4744   if (info->in_drag)
4745     {
4746       info->in_drag = 0;
4747
4748       get_layout_index (label, event->x, event->y, &index);
4749       gtk_label_select_region_index (label, index, index);
4750
4751       return FALSE;
4752     }
4753
4754   if (event->button != GDK_BUTTON_PRIMARY)
4755     return FALSE;
4756
4757   if (info->active_link &&
4758       info->selection_anchor == info->selection_end &&
4759       info->link_clicked)
4760     {
4761       emit_activate_link (label, info->active_link);
4762       info->link_clicked = 0;
4763
4764       return TRUE;
4765     }
4766
4767   /* The goal here is to return TRUE iff we ate the
4768    * button press to start selecting.
4769    */
4770   return TRUE;
4771 }
4772
4773 static void
4774 connect_mnemonics_visible_notify (GtkLabel *label)
4775 {
4776   GtkLabelPrivate *priv = label->priv;
4777   GtkWidget *toplevel;
4778   gboolean connected;
4779
4780   toplevel = gtk_widget_get_toplevel (GTK_WIDGET (label));
4781
4782   if (!GTK_IS_WINDOW (toplevel))
4783     return;
4784
4785   /* always set up this widgets initial value */
4786   priv->mnemonics_visible =
4787     gtk_window_get_mnemonics_visible (GTK_WINDOW (toplevel));
4788
4789   connected =
4790     GPOINTER_TO_INT (g_object_get_data (G_OBJECT (toplevel),
4791                                         "gtk-label-mnemonics-visible-connected"));
4792
4793   if (!connected)
4794     {
4795       g_signal_connect (toplevel,
4796                         "notify::mnemonics-visible",
4797                         G_CALLBACK (label_mnemonics_visible_changed),
4798                         label);
4799       g_object_set_data (G_OBJECT (toplevel),
4800                          "gtk-label-mnemonics-visible-connected",
4801                          GINT_TO_POINTER (1));
4802     }
4803 }
4804
4805 static void
4806 drag_begin_cb (GtkWidget      *widget,
4807                GdkDragContext *context,
4808                gpointer        data)
4809 {
4810   GtkLabel *label = GTK_LABEL (widget);
4811   GtkLabelPrivate *priv = label->priv;
4812   cairo_surface_t *surface = NULL;
4813
4814   g_signal_handlers_disconnect_by_func (widget, drag_begin_cb, NULL);
4815
4816   if ((priv->select_info->selection_anchor !=
4817        priv->select_info->selection_end) &&
4818       priv->text)
4819     {
4820       gint start, end;
4821       gint len;
4822
4823       start = MIN (priv->select_info->selection_anchor,
4824                    priv->select_info->selection_end);
4825       end = MAX (priv->select_info->selection_anchor,
4826                  priv->select_info->selection_end);
4827
4828       len = strlen (priv->text);
4829
4830       if (end > len)
4831         end = len;
4832
4833       if (start > len)
4834         start = len;
4835
4836       surface = _gtk_text_util_create_drag_icon (widget,
4837                                                  priv->text + start,
4838                                                  end - start);
4839     }
4840
4841   if (surface)
4842     {
4843       gtk_drag_set_icon_surface (context, surface);
4844       cairo_surface_destroy (surface);
4845     }
4846   else
4847     {
4848       gtk_drag_set_icon_default (context);
4849     }
4850 }
4851
4852 static gboolean
4853 gtk_label_motion (GtkWidget      *widget,
4854                   GdkEventMotion *event)
4855 {
4856   GtkLabel *label = GTK_LABEL (widget);
4857   GtkLabelPrivate *priv = label->priv;
4858   GtkLabelSelectionInfo *info = priv->select_info;
4859   gint index;
4860
4861   if (info == NULL)
4862     return FALSE;
4863
4864   if (info->links && !info->in_drag)
4865     {
4866       GList *l;
4867       GtkLabelLink *link;
4868       gboolean found = FALSE;
4869
4870       if (info->selection_anchor == info->selection_end)
4871         {
4872           if (get_layout_index (label, event->x, event->y, &index))
4873             {
4874               for (l = info->links; l != NULL; l = l->next)
4875                 {
4876                   link = l->data;
4877                   if (index >= link->start && index <= link->end)
4878                     {
4879                       found = TRUE;
4880                       break;
4881                     }
4882                 }
4883             }
4884         }
4885
4886       if (found)
4887         {
4888           if (info->active_link != link)
4889             {
4890               info->link_clicked = 0;
4891               info->active_link = link;
4892               gtk_label_update_cursor (label);
4893               gtk_widget_queue_draw (widget);
4894             }
4895         }
4896       else
4897         {
4898           if (info->active_link != NULL)
4899             {
4900               info->link_clicked = 0;
4901               info->active_link = NULL;
4902               gtk_label_update_cursor (label);
4903               gtk_widget_queue_draw (widget);
4904             }
4905         }
4906     }
4907
4908   if (!info->selectable)
4909     return FALSE;
4910
4911   if ((event->state & GDK_BUTTON1_MASK) == 0)
4912     return FALSE;
4913
4914   if (info->in_drag)
4915     {
4916       if (gtk_drag_check_threshold (widget,
4917                                     info->drag_start_x,
4918                                     info->drag_start_y,
4919                                     event->x, event->y))
4920         {
4921           GtkTargetList *target_list = gtk_target_list_new (NULL, 0);
4922
4923           gtk_target_list_add_text_targets (target_list, 0);
4924
4925           g_signal_connect (widget, "drag-begin",
4926                             G_CALLBACK (drag_begin_cb), NULL);
4927           gtk_drag_begin (widget, target_list,
4928                           GDK_ACTION_COPY,
4929                           1, (GdkEvent *)event);
4930
4931           info->in_drag = FALSE;
4932
4933           gtk_target_list_unref (target_list);
4934         }
4935     }
4936   else
4937     {
4938       gint x, y;
4939
4940       gdk_window_get_device_position (info->window, event->device, &x, &y, NULL);
4941       get_layout_index (label, x, y, &index);
4942
4943       if (info->select_words)
4944         {
4945           gint min, max;
4946           gint old_min, old_max;
4947           gint anchor, end;
4948
4949           min = gtk_label_move_backward_word (label, index);
4950           max = gtk_label_move_forward_word (label, index);
4951
4952           anchor = info->selection_anchor;
4953           end = info->selection_end;
4954
4955           old_min = MIN (anchor, end);
4956           old_max = MAX (anchor, end);
4957
4958           if (min < old_min)
4959             {
4960               anchor = min;
4961               end = old_max;
4962             }
4963           else if (old_max < max)
4964             {
4965               anchor = max;
4966               end = old_min;
4967             }
4968           else if (anchor == old_min)
4969             {
4970               if (anchor != min)
4971                 anchor = max;
4972             }
4973           else
4974             {
4975               if (anchor != max)
4976                 anchor = min;
4977             }
4978
4979           gtk_label_select_region_index (label, anchor, end);
4980         }
4981       else
4982         gtk_label_select_region_index (label, info->selection_anchor, index);
4983     }
4984
4985   return TRUE;
4986 }
4987
4988 static gboolean
4989 gtk_label_leave_notify (GtkWidget        *widget,
4990                         GdkEventCrossing *event)
4991 {
4992   GtkLabel *label = GTK_LABEL (widget);
4993   GtkLabelPrivate *priv = label->priv;
4994
4995   if (priv->select_info)
4996     {
4997       priv->select_info->active_link = NULL;
4998       gtk_label_update_cursor (label);
4999       gtk_widget_queue_draw (widget);
5000     }
5001
5002   if (GTK_WIDGET_CLASS (gtk_label_parent_class)->leave_notify_event)
5003     return GTK_WIDGET_CLASS (gtk_label_parent_class)->leave_notify_event (widget, event);
5004
5005  return FALSE;
5006 }
5007
5008 static void
5009 gtk_label_create_window (GtkLabel *label)
5010 {
5011   GtkLabelPrivate *priv = label->priv;
5012   GtkAllocation allocation;
5013   GtkWidget *widget;
5014   GdkWindowAttr attributes;
5015   gint attributes_mask;
5016
5017   g_assert (priv->select_info);
5018   widget = GTK_WIDGET (label);
5019   g_assert (gtk_widget_get_realized (widget));
5020
5021   if (priv->select_info->window)
5022     return;
5023
5024   gtk_widget_get_allocation (widget, &allocation);
5025
5026   attributes.x = allocation.x;
5027   attributes.y = allocation.y;
5028   attributes.width = allocation.width;
5029   attributes.height = allocation.height;
5030   attributes.window_type = GDK_WINDOW_CHILD;
5031   attributes.wclass = GDK_INPUT_ONLY;
5032   attributes.override_redirect = TRUE;
5033   attributes.event_mask = gtk_widget_get_events (widget) |
5034     GDK_BUTTON_PRESS_MASK        |
5035     GDK_BUTTON_RELEASE_MASK      |
5036     GDK_LEAVE_NOTIFY_MASK        |
5037     GDK_BUTTON_MOTION_MASK       |
5038     GDK_POINTER_MOTION_MASK      |
5039     GDK_POINTER_MOTION_HINT_MASK;
5040   attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_NOREDIR;
5041   if (gtk_widget_is_sensitive (widget))
5042     {
5043       attributes.cursor = gdk_cursor_new_for_display (gtk_widget_get_display (widget),
5044                                                       GDK_XTERM);
5045       attributes_mask |= GDK_WA_CURSOR;
5046     }
5047
5048
5049   priv->select_info->window = gdk_window_new (gtk_widget_get_window (widget),
5050                                                &attributes, attributes_mask);
5051   gdk_window_set_user_data (priv->select_info->window, widget);
5052
5053   if (attributes_mask & GDK_WA_CURSOR)
5054     g_object_unref (attributes.cursor);
5055 }
5056
5057 static void
5058 gtk_label_destroy_window (GtkLabel *label)
5059 {
5060   GtkLabelPrivate *priv = label->priv;
5061
5062   g_assert (priv->select_info);
5063
5064   if (priv->select_info->window == NULL)
5065     return;
5066
5067   gdk_window_set_user_data (priv->select_info->window, NULL);
5068   gdk_window_destroy (priv->select_info->window);
5069   priv->select_info->window = NULL;
5070 }
5071
5072 static void
5073 gtk_label_ensure_select_info (GtkLabel *label)
5074 {
5075   GtkLabelPrivate *priv = label->priv;
5076
5077   if (priv->select_info == NULL)
5078     {
5079       priv->select_info = g_new0 (GtkLabelSelectionInfo, 1);
5080
5081       gtk_widget_set_can_focus (GTK_WIDGET (label), TRUE);
5082
5083       if (gtk_widget_get_realized (GTK_WIDGET (label)))
5084         gtk_label_create_window (label);
5085
5086       if (gtk_widget_get_mapped (GTK_WIDGET (label)))
5087         gdk_window_show (priv->select_info->window);
5088     }
5089 }
5090
5091 static void
5092 gtk_label_clear_select_info (GtkLabel *label)
5093 {
5094   GtkLabelPrivate *priv = label->priv;
5095
5096   if (priv->select_info == NULL)
5097     return;
5098
5099   if (!priv->select_info->selectable && !priv->select_info->links)
5100     {
5101       gtk_label_destroy_window (label);
5102
5103       g_free (priv->select_info);
5104       priv->select_info = NULL;
5105
5106       gtk_widget_set_can_focus (GTK_WIDGET (label), FALSE);
5107     }
5108 }
5109
5110 /**
5111  * gtk_label_set_selectable:
5112  * @label: a #GtkLabel
5113  * @setting: %TRUE to allow selecting text in the label
5114  *
5115  * Selectable labels allow the user to select text from the label, for
5116  * copy-and-paste.
5117  **/
5118 void
5119 gtk_label_set_selectable (GtkLabel *label,
5120                           gboolean  setting)
5121 {
5122   GtkLabelPrivate *priv;
5123   gboolean old_setting;
5124
5125   g_return_if_fail (GTK_IS_LABEL (label));
5126
5127   priv = label->priv;
5128
5129   setting = setting != FALSE;
5130   old_setting = priv->select_info && priv->select_info->selectable;
5131
5132   if (setting)
5133     {
5134       gtk_label_ensure_select_info (label);
5135       priv->select_info->selectable = TRUE;
5136       gtk_label_update_cursor (label);
5137     }
5138   else
5139     {
5140       if (old_setting)
5141         {
5142           /* unselect, to give up the selection */
5143           gtk_label_select_region (label, 0, 0);
5144
5145           priv->select_info->selectable = FALSE;
5146           gtk_label_clear_select_info (label);
5147           gtk_label_update_cursor (label);
5148         }
5149     }
5150   if (setting != old_setting)
5151     {
5152       g_object_freeze_notify (G_OBJECT (label));
5153       g_object_notify (G_OBJECT (label), "selectable");
5154       g_object_notify (G_OBJECT (label), "cursor-position");
5155       g_object_notify (G_OBJECT (label), "selection-bound");
5156       g_object_thaw_notify (G_OBJECT (label));
5157       gtk_widget_queue_draw (GTK_WIDGET (label));
5158     }
5159 }
5160
5161 /**
5162  * gtk_label_get_selectable:
5163  * @label: a #GtkLabel
5164  *
5165  * Gets the value set by gtk_label_set_selectable().
5166  *
5167  * Return value: %TRUE if the user can copy text from the label
5168  **/
5169 gboolean
5170 gtk_label_get_selectable (GtkLabel *label)
5171 {
5172   GtkLabelPrivate *priv;
5173
5174   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5175
5176   priv = label->priv;
5177
5178   return priv->select_info && priv->select_info->selectable;
5179 }
5180
5181 /**
5182  * gtk_label_set_angle:
5183  * @label: a #GtkLabel
5184  * @angle: the angle that the baseline of the label makes with
5185  *   the horizontal, in degrees, measured counterclockwise
5186  *
5187  * Sets the angle of rotation for the label. An angle of 90 reads from
5188  * from bottom to top, an angle of 270, from top to bottom. The angle
5189  * setting for the label is ignored if the label is selectable,
5190  * wrapped, or ellipsized.
5191  *
5192  * Since: 2.6
5193  **/
5194 void
5195 gtk_label_set_angle (GtkLabel *label,
5196                      gdouble   angle)
5197 {
5198   GtkLabelPrivate *priv;
5199
5200   g_return_if_fail (GTK_IS_LABEL (label));
5201
5202   priv = label->priv;
5203
5204   /* Canonicalize to [0,360]. We don't canonicalize 360 to 0, because
5205    * double property ranges are inclusive, and changing 360 to 0 would
5206    * make a property editor behave strangely.
5207    */
5208   if (angle < 0 || angle > 360.0)
5209     angle = angle - 360. * floor (angle / 360.);
5210
5211   if (priv->angle != angle)
5212     {
5213       priv->angle = angle;
5214
5215       gtk_label_clear_layout (label);
5216       gtk_widget_queue_resize (GTK_WIDGET (label));
5217
5218       g_object_notify (G_OBJECT (label), "angle");
5219     }
5220 }
5221
5222 /**
5223  * gtk_label_get_angle:
5224  * @label: a #GtkLabel
5225  *
5226  * Gets the angle of rotation for the label. See
5227  * gtk_label_set_angle().
5228  *
5229  * Return value: the angle of rotation for the label
5230  *
5231  * Since: 2.6
5232  **/
5233 gdouble
5234 gtk_label_get_angle  (GtkLabel *label)
5235 {
5236   g_return_val_if_fail (GTK_IS_LABEL (label), 0.0);
5237
5238   return label->priv->angle;
5239 }
5240
5241 static void
5242 gtk_label_set_selection_text (GtkLabel         *label,
5243                               GtkSelectionData *selection_data)
5244 {
5245   GtkLabelPrivate *priv = label->priv;
5246
5247   if (priv->select_info &&
5248       (priv->select_info->selection_anchor !=
5249        priv->select_info->selection_end) &&
5250       priv->text)
5251     {
5252       gint start, end;
5253       gint len;
5254
5255       start = MIN (priv->select_info->selection_anchor,
5256                    priv->select_info->selection_end);
5257       end = MAX (priv->select_info->selection_anchor,
5258                  priv->select_info->selection_end);
5259
5260       len = strlen (priv->text);
5261
5262       if (end > len)
5263         end = len;
5264
5265       if (start > len)
5266         start = len;
5267
5268       gtk_selection_data_set_text (selection_data,
5269                                    priv->text + start,
5270                                    end - start);
5271     }
5272 }
5273
5274 static void
5275 gtk_label_drag_data_get (GtkWidget        *widget,
5276                          GdkDragContext   *context,
5277                          GtkSelectionData *selection_data,
5278                          guint             info,
5279                          guint             time)
5280 {
5281   gtk_label_set_selection_text (GTK_LABEL (widget), selection_data);
5282 }
5283
5284 static void
5285 get_text_callback (GtkClipboard     *clipboard,
5286                    GtkSelectionData *selection_data,
5287                    guint             info,
5288                    gpointer          user_data_or_owner)
5289 {
5290   gtk_label_set_selection_text (GTK_LABEL (user_data_or_owner), selection_data);
5291 }
5292
5293 static void
5294 clear_text_callback (GtkClipboard     *clipboard,
5295                      gpointer          user_data_or_owner)
5296 {
5297   GtkLabel *label;
5298   GtkLabelPrivate *priv;
5299
5300   label = GTK_LABEL (user_data_or_owner);
5301   priv = label->priv;
5302
5303   if (priv->select_info)
5304     {
5305       priv->select_info->selection_anchor = priv->select_info->selection_end;
5306
5307       gtk_widget_queue_draw (GTK_WIDGET (label));
5308     }
5309 }
5310
5311 static void
5312 gtk_label_select_region_index (GtkLabel *label,
5313                                gint      anchor_index,
5314                                gint      end_index)
5315 {
5316   GtkLabelPrivate *priv;
5317
5318   g_return_if_fail (GTK_IS_LABEL (label));
5319
5320   priv = label->priv;
5321
5322   if (priv->select_info && priv->select_info->selectable)
5323     {
5324       GtkClipboard *clipboard;
5325
5326       if (priv->select_info->selection_anchor == anchor_index &&
5327           priv->select_info->selection_end == end_index)
5328         return;
5329
5330       g_object_freeze_notify (G_OBJECT (label));
5331
5332       if (priv->select_info->selection_anchor != anchor_index)
5333         g_object_notify (G_OBJECT (label), "selection-bound");
5334       if (priv->select_info->selection_end != end_index)
5335         g_object_notify (G_OBJECT (label), "cursor-position");
5336
5337       priv->select_info->selection_anchor = anchor_index;
5338       priv->select_info->selection_end = end_index;
5339
5340       if (gtk_widget_has_screen (GTK_WIDGET (label)))
5341         clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label),
5342                                               GDK_SELECTION_PRIMARY);
5343       else
5344         clipboard = NULL;
5345
5346       if (anchor_index != end_index)
5347         {
5348           GtkTargetList *list;
5349           GtkTargetEntry *targets;
5350           gint n_targets;
5351
5352           list = gtk_target_list_new (NULL, 0);
5353           gtk_target_list_add_text_targets (list, 0);
5354           targets = gtk_target_table_new_from_list (list, &n_targets);
5355
5356           if (clipboard)
5357             gtk_clipboard_set_with_owner (clipboard,
5358                                           targets, n_targets,
5359                                           get_text_callback,
5360                                           clear_text_callback,
5361                                           G_OBJECT (label));
5362
5363           gtk_target_table_free (targets, n_targets);
5364           gtk_target_list_unref (list);
5365         }
5366       else
5367         {
5368           if (clipboard &&
5369               gtk_clipboard_get_owner (clipboard) == G_OBJECT (label))
5370             gtk_clipboard_clear (clipboard);
5371         }
5372
5373       gtk_widget_queue_draw (GTK_WIDGET (label));
5374
5375       g_object_thaw_notify (G_OBJECT (label));
5376     }
5377 }
5378
5379 /**
5380  * gtk_label_select_region:
5381  * @label: a #GtkLabel
5382  * @start_offset: start offset (in characters not bytes)
5383  * @end_offset: end offset (in characters not bytes)
5384  *
5385  * Selects a range of characters in the label, if the label is selectable.
5386  * See gtk_label_set_selectable(). If the label is not selectable,
5387  * this function has no effect. If @start_offset or
5388  * @end_offset are -1, then the end of the label will be substituted.
5389  **/
5390 void
5391 gtk_label_select_region  (GtkLabel *label,
5392                           gint      start_offset,
5393                           gint      end_offset)
5394 {
5395   GtkLabelPrivate *priv;
5396
5397   g_return_if_fail (GTK_IS_LABEL (label));
5398
5399   priv = label->priv;
5400
5401   if (priv->text && priv->select_info)
5402     {
5403       if (start_offset < 0)
5404         start_offset = g_utf8_strlen (priv->text, -1);
5405
5406       if (end_offset < 0)
5407         end_offset = g_utf8_strlen (priv->text, -1);
5408
5409       gtk_label_select_region_index (label,
5410                                      g_utf8_offset_to_pointer (priv->text, start_offset) - priv->text,
5411                                      g_utf8_offset_to_pointer (priv->text, end_offset) - priv->text);
5412     }
5413 }
5414
5415 /**
5416  * gtk_label_get_selection_bounds:
5417  * @label: a #GtkLabel
5418  * @start: (out): return location for start of selection, as a character offset
5419  * @end: (out): return location for end of selection, as a character offset
5420  *
5421  * Gets the selected range of characters in the label, returning %TRUE
5422  * if there's a selection.
5423  *
5424  * Return value: %TRUE if selection is non-empty
5425  **/
5426 gboolean
5427 gtk_label_get_selection_bounds (GtkLabel  *label,
5428                                 gint      *start,
5429                                 gint      *end)
5430 {
5431   GtkLabelPrivate *priv;
5432
5433   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5434
5435   priv = label->priv;
5436
5437   if (priv->select_info == NULL)
5438     {
5439       /* not a selectable label */
5440       if (start)
5441         *start = 0;
5442       if (end)
5443         *end = 0;
5444
5445       return FALSE;
5446     }
5447   else
5448     {
5449       gint start_index, end_index;
5450       gint start_offset, end_offset;
5451       gint len;
5452
5453       start_index = MIN (priv->select_info->selection_anchor,
5454                    priv->select_info->selection_end);
5455       end_index = MAX (priv->select_info->selection_anchor,
5456                  priv->select_info->selection_end);
5457
5458       len = strlen (priv->text);
5459
5460       if (end_index > len)
5461         end_index = len;
5462
5463       if (start_index > len)
5464         start_index = len;
5465
5466       start_offset = g_utf8_strlen (priv->text, start_index);
5467       end_offset = g_utf8_strlen (priv->text, end_index);
5468
5469       if (start_offset > end_offset)
5470         {
5471           gint tmp = start_offset;
5472           start_offset = end_offset;
5473           end_offset = tmp;
5474         }
5475
5476       if (start)
5477         *start = start_offset;
5478
5479       if (end)
5480         *end = end_offset;
5481
5482       return start_offset != end_offset;
5483     }
5484 }
5485
5486
5487 /**
5488  * gtk_label_get_layout:
5489  * @label: a #GtkLabel
5490  *
5491  * Gets the #PangoLayout used to display the label.
5492  * The layout is useful to e.g. convert text positions to
5493  * pixel positions, in combination with gtk_label_get_layout_offsets().
5494  * The returned layout is owned by the @label so need not be
5495  * freed by the caller. The @label is free to recreate its layout at
5496  * any time, so it should be considered read-only.
5497  *
5498  * Return value: (transfer none): the #PangoLayout for this label
5499  **/
5500 PangoLayout*
5501 gtk_label_get_layout (GtkLabel *label)
5502 {
5503   GtkLabelPrivate *priv;
5504
5505   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
5506
5507   priv = label->priv;
5508
5509   gtk_label_ensure_layout (label);
5510
5511   return priv->layout;
5512 }
5513
5514 /**
5515  * gtk_label_get_layout_offsets:
5516  * @label: a #GtkLabel
5517  * @x: (out) (allow-none): location to store X offset of layout, or %NULL
5518  * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
5519  *
5520  * Obtains the coordinates where the label will draw the #PangoLayout
5521  * representing the text in the label; useful to convert mouse events
5522  * into coordinates inside the #PangoLayout, e.g. to take some action
5523  * if some part of the label is clicked. Of course you will need to
5524  * create a #GtkEventBox to receive the events, and pack the label
5525  * inside it, since labels are a #GTK_NO_WINDOW widget. Remember
5526  * when using the #PangoLayout functions you need to convert to
5527  * and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
5528  **/
5529 void
5530 gtk_label_get_layout_offsets (GtkLabel *label,
5531                               gint     *x,
5532                               gint     *y)
5533 {
5534   g_return_if_fail (GTK_IS_LABEL (label));
5535
5536   gtk_label_ensure_layout (label);
5537
5538   get_layout_location (label, x, y);
5539 }
5540
5541 /**
5542  * gtk_label_set_use_markup:
5543  * @label: a #GtkLabel
5544  * @setting: %TRUE if the label's text should be parsed for markup.
5545  *
5546  * Sets whether the text of the label contains markup in <link
5547  * linkend="PangoMarkupFormat">Pango's text markup
5548  * language</link>. See gtk_label_set_markup().
5549  **/
5550 void
5551 gtk_label_set_use_markup (GtkLabel *label,
5552                           gboolean  setting)
5553 {
5554   g_return_if_fail (GTK_IS_LABEL (label));
5555
5556   g_object_freeze_notify (G_OBJECT (label));
5557
5558   gtk_label_set_use_markup_internal (label, setting);
5559   gtk_label_recalculate (label);
5560
5561   g_object_thaw_notify (G_OBJECT (label));
5562 }
5563
5564 /**
5565  * gtk_label_get_use_markup:
5566  * @label: a #GtkLabel
5567  *
5568  * Returns whether the label's text is interpreted as marked up with
5569  * the <link linkend="PangoMarkupFormat">Pango text markup
5570  * language</link>. See gtk_label_set_use_markup ().
5571  *
5572  * Return value: %TRUE if the label's text will be parsed for markup.
5573  **/
5574 gboolean
5575 gtk_label_get_use_markup (GtkLabel *label)
5576 {
5577   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5578
5579   return label->priv->use_markup;
5580 }
5581
5582 /**
5583  * gtk_label_set_use_underline:
5584  * @label: a #GtkLabel
5585  * @setting: %TRUE if underlines in the text indicate mnemonics
5586  *
5587  * If true, an underline in the text indicates the next character should be
5588  * used for the mnemonic accelerator key.
5589  */
5590 void
5591 gtk_label_set_use_underline (GtkLabel *label,
5592                              gboolean  setting)
5593 {
5594   g_return_if_fail (GTK_IS_LABEL (label));
5595
5596   g_object_freeze_notify (G_OBJECT (label));
5597
5598   gtk_label_set_use_underline_internal (label, setting);
5599   gtk_label_recalculate (label);
5600
5601   g_object_thaw_notify (G_OBJECT (label));
5602 }
5603
5604 /**
5605  * gtk_label_get_use_underline:
5606  * @label: a #GtkLabel
5607  *
5608  * Returns whether an embedded underline in the label indicates a
5609  * mnemonic. See gtk_label_set_use_underline().
5610  *
5611  * Return value: %TRUE whether an embedded underline in the label indicates
5612  *               the mnemonic accelerator keys.
5613  **/
5614 gboolean
5615 gtk_label_get_use_underline (GtkLabel *label)
5616 {
5617   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5618
5619   return label->priv->use_underline;
5620 }
5621
5622 /**
5623  * gtk_label_set_single_line_mode:
5624  * @label: a #GtkLabel
5625  * @single_line_mode: %TRUE if the label should be in single line mode
5626  *
5627  * Sets whether the label is in single line mode.
5628  *
5629  * Since: 2.6
5630  */
5631 void
5632 gtk_label_set_single_line_mode (GtkLabel *label,
5633                                 gboolean single_line_mode)
5634 {
5635   GtkLabelPrivate *priv;
5636
5637   g_return_if_fail (GTK_IS_LABEL (label));
5638
5639   priv = label->priv;
5640
5641   single_line_mode = single_line_mode != FALSE;
5642
5643   if (priv->single_line_mode != single_line_mode)
5644     {
5645       priv->single_line_mode = single_line_mode;
5646
5647       gtk_label_clear_layout (label);
5648       gtk_widget_queue_resize (GTK_WIDGET (label));
5649
5650       g_object_notify (G_OBJECT (label), "single-line-mode");
5651     }
5652 }
5653
5654 /**
5655  * gtk_label_get_single_line_mode:
5656  * @label: a #GtkLabel
5657  *
5658  * Returns whether the label is in single line mode.
5659  *
5660  * Return value: %TRUE when the label is in single line mode.
5661  *
5662  * Since: 2.6
5663  **/
5664 gboolean
5665 gtk_label_get_single_line_mode  (GtkLabel *label)
5666 {
5667   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
5668
5669   return label->priv->single_line_mode;
5670 }
5671
5672 /* Compute the X position for an offset that corresponds to the "more important
5673  * cursor position for that offset. We use this when trying to guess to which
5674  * end of the selection we should go to when the user hits the left or
5675  * right arrow key.
5676  */
5677 static void
5678 get_better_cursor (GtkLabel *label,
5679                    gint      index,
5680                    gint      *x,
5681                    gint      *y)
5682 {
5683   GtkLabelPrivate *priv = label->priv;
5684   GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
5685   PangoDirection keymap_direction = gdk_keymap_get_direction (keymap);
5686   PangoDirection cursor_direction = get_cursor_direction (label);
5687   gboolean split_cursor;
5688   PangoRectangle strong_pos, weak_pos;
5689
5690   g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
5691                 "gtk-split-cursor", &split_cursor,
5692                 NULL);
5693
5694   gtk_label_ensure_layout (label);
5695
5696   pango_layout_get_cursor_pos (priv->layout, index,
5697                                &strong_pos, &weak_pos);
5698
5699   if (split_cursor)
5700     {
5701       *x = strong_pos.x / PANGO_SCALE;
5702       *y = strong_pos.y / PANGO_SCALE;
5703     }
5704   else
5705     {
5706       if (keymap_direction == cursor_direction)
5707         {
5708           *x = strong_pos.x / PANGO_SCALE;
5709           *y = strong_pos.y / PANGO_SCALE;
5710         }
5711       else
5712         {
5713           *x = weak_pos.x / PANGO_SCALE;
5714           *y = weak_pos.y / PANGO_SCALE;
5715         }
5716     }
5717 }
5718
5719
5720 static gint
5721 gtk_label_move_logically (GtkLabel *label,
5722                           gint      start,
5723                           gint      count)
5724 {
5725   GtkLabelPrivate *priv = label->priv;
5726   gint offset = g_utf8_pointer_to_offset (priv->text,
5727                                           priv->text + start);
5728
5729   if (priv->text)
5730     {
5731       PangoLogAttr *log_attrs;
5732       gint n_attrs;
5733       gint length;
5734
5735       gtk_label_ensure_layout (label);
5736
5737       length = g_utf8_strlen (priv->text, -1);
5738
5739       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5740
5741       while (count > 0 && offset < length)
5742         {
5743           do
5744             offset++;
5745           while (offset < length && !log_attrs[offset].is_cursor_position);
5746
5747           count--;
5748         }
5749       while (count < 0 && offset > 0)
5750         {
5751           do
5752             offset--;
5753           while (offset > 0 && !log_attrs[offset].is_cursor_position);
5754
5755           count++;
5756         }
5757
5758       g_free (log_attrs);
5759     }
5760
5761   return g_utf8_offset_to_pointer (priv->text, offset) - priv->text;
5762 }
5763
5764 static gint
5765 gtk_label_move_visually (GtkLabel *label,
5766                          gint      start,
5767                          gint      count)
5768 {
5769   GtkLabelPrivate *priv = label->priv;
5770   gint index;
5771
5772   index = start;
5773
5774   while (count != 0)
5775     {
5776       int new_index, new_trailing;
5777       gboolean split_cursor;
5778       gboolean strong;
5779
5780       gtk_label_ensure_layout (label);
5781
5782       g_object_get (gtk_widget_get_settings (GTK_WIDGET (label)),
5783                     "gtk-split-cursor", &split_cursor,
5784                     NULL);
5785
5786       if (split_cursor)
5787         strong = TRUE;
5788       else
5789         {
5790           GdkKeymap *keymap = gdk_keymap_get_for_display (gtk_widget_get_display (GTK_WIDGET (label)));
5791           PangoDirection keymap_direction = gdk_keymap_get_direction (keymap);
5792
5793           strong = keymap_direction == get_cursor_direction (label);
5794         }
5795
5796       if (count > 0)
5797         {
5798           pango_layout_move_cursor_visually (priv->layout, strong, index, 0, 1, &new_index, &new_trailing);
5799           count--;
5800         }
5801       else
5802         {
5803           pango_layout_move_cursor_visually (priv->layout, strong, index, 0, -1, &new_index, &new_trailing);
5804           count++;
5805         }
5806
5807       if (new_index < 0 || new_index == G_MAXINT)
5808         break;
5809
5810       index = new_index;
5811
5812       while (new_trailing--)
5813         index = g_utf8_next_char (priv->text + new_index) - priv->text;
5814     }
5815
5816   return index;
5817 }
5818
5819 static gint
5820 gtk_label_move_forward_word (GtkLabel *label,
5821                              gint      start)
5822 {
5823   GtkLabelPrivate *priv = label->priv;
5824   gint new_pos = g_utf8_pointer_to_offset (priv->text,
5825                                            priv->text + start);
5826   gint length;
5827
5828   length = g_utf8_strlen (priv->text, -1);
5829   if (new_pos < length)
5830     {
5831       PangoLogAttr *log_attrs;
5832       gint n_attrs;
5833
5834       gtk_label_ensure_layout (label);
5835
5836       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5837
5838       /* Find the next word end */
5839       new_pos++;
5840       while (new_pos < n_attrs && !log_attrs[new_pos].is_word_end)
5841         new_pos++;
5842
5843       g_free (log_attrs);
5844     }
5845
5846   return g_utf8_offset_to_pointer (priv->text, new_pos) - priv->text;
5847 }
5848
5849
5850 static gint
5851 gtk_label_move_backward_word (GtkLabel *label,
5852                               gint      start)
5853 {
5854   GtkLabelPrivate *priv = label->priv;
5855   gint new_pos = g_utf8_pointer_to_offset (priv->text,
5856                                            priv->text + start);
5857
5858   if (new_pos > 0)
5859     {
5860       PangoLogAttr *log_attrs;
5861       gint n_attrs;
5862
5863       gtk_label_ensure_layout (label);
5864
5865       pango_layout_get_log_attrs (priv->layout, &log_attrs, &n_attrs);
5866
5867       new_pos -= 1;
5868
5869       /* Find the previous word beginning */
5870       while (new_pos > 0 && !log_attrs[new_pos].is_word_start)
5871         new_pos--;
5872
5873       g_free (log_attrs);
5874     }
5875
5876   return g_utf8_offset_to_pointer (priv->text, new_pos) - priv->text;
5877 }
5878
5879 static void
5880 gtk_label_move_cursor (GtkLabel       *label,
5881                        GtkMovementStep step,
5882                        gint            count,
5883                        gboolean        extend_selection)
5884 {
5885   GtkLabelPrivate *priv = label->priv;
5886   gint old_pos;
5887   gint new_pos;
5888
5889   if (priv->select_info == NULL)
5890     return;
5891
5892   old_pos = new_pos = priv->select_info->selection_end;
5893
5894   if (priv->select_info->selection_end != priv->select_info->selection_anchor &&
5895       !extend_selection)
5896     {
5897       /* If we have a current selection and aren't extending it, move to the
5898        * start/or end of the selection as appropriate
5899        */
5900       switch (step)
5901         {
5902         case GTK_MOVEMENT_VISUAL_POSITIONS:
5903           {
5904             gint end_x, end_y;
5905             gint anchor_x, anchor_y;
5906             gboolean end_is_left;
5907
5908             get_better_cursor (label, priv->select_info->selection_end, &end_x, &end_y);
5909             get_better_cursor (label, priv->select_info->selection_anchor, &anchor_x, &anchor_y);
5910
5911             end_is_left = (end_y < anchor_y) || (end_y == anchor_y && end_x < anchor_x);
5912
5913             if (count < 0)
5914               new_pos = end_is_left ? priv->select_info->selection_end : priv->select_info->selection_anchor;
5915             else
5916               new_pos = !end_is_left ? priv->select_info->selection_end : priv->select_info->selection_anchor;
5917             break;
5918           }
5919         case GTK_MOVEMENT_LOGICAL_POSITIONS:
5920         case GTK_MOVEMENT_WORDS:
5921           if (count < 0)
5922             new_pos = MIN (priv->select_info->selection_end, priv->select_info->selection_anchor);
5923           else
5924             new_pos = MAX (priv->select_info->selection_end, priv->select_info->selection_anchor);
5925           break;
5926         case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
5927         case GTK_MOVEMENT_PARAGRAPH_ENDS:
5928         case GTK_MOVEMENT_BUFFER_ENDS:
5929           /* FIXME: Can do better here */
5930           new_pos = count < 0 ? 0 : strlen (priv->text);
5931           break;
5932         case GTK_MOVEMENT_DISPLAY_LINES:
5933         case GTK_MOVEMENT_PARAGRAPHS:
5934         case GTK_MOVEMENT_PAGES:
5935         case GTK_MOVEMENT_HORIZONTAL_PAGES:
5936           break;
5937         }
5938     }
5939   else
5940     {
5941       switch (step)
5942         {
5943         case GTK_MOVEMENT_LOGICAL_POSITIONS:
5944           new_pos = gtk_label_move_logically (label, new_pos, count);
5945           break;
5946         case GTK_MOVEMENT_VISUAL_POSITIONS:
5947           new_pos = gtk_label_move_visually (label, new_pos, count);
5948           if (new_pos == old_pos)
5949             {
5950               if (!extend_selection)
5951                 {
5952                   if (!gtk_widget_keynav_failed (GTK_WIDGET (label),
5953                                                  count > 0 ?
5954                                                  GTK_DIR_RIGHT : GTK_DIR_LEFT))
5955                     {
5956                       GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (label));
5957
5958                       if (toplevel)
5959                         gtk_widget_child_focus (toplevel,
5960                                                 count > 0 ?
5961                                                 GTK_DIR_RIGHT : GTK_DIR_LEFT);
5962                     }
5963                 }
5964               else
5965                 {
5966                   gtk_widget_error_bell (GTK_WIDGET (label));
5967                 }
5968             }
5969           break;
5970         case GTK_MOVEMENT_WORDS:
5971           while (count > 0)
5972             {
5973               new_pos = gtk_label_move_forward_word (label, new_pos);
5974               count--;
5975             }
5976           while (count < 0)
5977             {
5978               new_pos = gtk_label_move_backward_word (label, new_pos);
5979               count++;
5980             }
5981           if (new_pos == old_pos)
5982             gtk_widget_error_bell (GTK_WIDGET (label));
5983           break;
5984         case GTK_MOVEMENT_DISPLAY_LINE_ENDS:
5985         case GTK_MOVEMENT_PARAGRAPH_ENDS:
5986         case GTK_MOVEMENT_BUFFER_ENDS:
5987           /* FIXME: Can do better here */
5988           new_pos = count < 0 ? 0 : strlen (priv->text);
5989           if (new_pos == old_pos)
5990             gtk_widget_error_bell (GTK_WIDGET (label));
5991           break;
5992         case GTK_MOVEMENT_DISPLAY_LINES:
5993         case GTK_MOVEMENT_PARAGRAPHS:
5994         case GTK_MOVEMENT_PAGES:
5995         case GTK_MOVEMENT_HORIZONTAL_PAGES:
5996           break;
5997         }
5998     }
5999
6000   if (extend_selection)
6001     gtk_label_select_region_index (label,
6002                                    priv->select_info->selection_anchor,
6003                                    new_pos);
6004   else
6005     gtk_label_select_region_index (label, new_pos, new_pos);
6006 }
6007
6008 static void
6009 gtk_label_copy_clipboard (GtkLabel *label)
6010 {
6011   GtkLabelPrivate *priv = label->priv;
6012
6013   if (priv->text && priv->select_info)
6014     {
6015       gint start, end;
6016       gint len;
6017       GtkClipboard *clipboard;
6018
6019       start = MIN (priv->select_info->selection_anchor,
6020                    priv->select_info->selection_end);
6021       end = MAX (priv->select_info->selection_anchor,
6022                  priv->select_info->selection_end);
6023
6024       len = strlen (priv->text);
6025
6026       if (end > len)
6027         end = len;
6028
6029       if (start > len)
6030         start = len;
6031
6032       clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label), GDK_SELECTION_CLIPBOARD);
6033
6034       if (start != end)
6035         gtk_clipboard_set_text (clipboard, priv->text + start, end - start);
6036       else
6037         {
6038           GtkLabelLink *link;
6039
6040           link = gtk_label_get_focus_link (label);
6041           if (link)
6042             gtk_clipboard_set_text (clipboard, link->uri, -1);
6043         }
6044     }
6045 }
6046
6047 static void
6048 gtk_label_select_all (GtkLabel *label)
6049 {
6050   GtkLabelPrivate *priv = label->priv;
6051
6052   gtk_label_select_region_index (label, 0, strlen (priv->text));
6053 }
6054
6055 /* Quick hack of a popup menu
6056  */
6057 static void
6058 activate_cb (GtkWidget *menuitem,
6059              GtkLabel  *label)
6060 {
6061   const gchar *signal = g_object_get_data (G_OBJECT (menuitem), "gtk-signal");
6062   g_signal_emit_by_name (label, signal);
6063 }
6064
6065 static void
6066 append_action_signal (GtkLabel     *label,
6067                       GtkWidget    *menu,
6068                       const gchar  *stock_id,
6069                       const gchar  *signal,
6070                       gboolean      sensitive)
6071 {
6072   GtkWidget *menuitem = gtk_image_menu_item_new_from_stock (stock_id, NULL);
6073
6074   g_object_set_data (G_OBJECT (menuitem), I_("gtk-signal"), (char *)signal);
6075   g_signal_connect (menuitem, "activate",
6076                     G_CALLBACK (activate_cb), label);
6077
6078   gtk_widget_set_sensitive (menuitem, sensitive);
6079
6080   gtk_widget_show (menuitem);
6081   gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6082 }
6083
6084 static void
6085 popup_menu_detach (GtkWidget *attach_widget,
6086                    GtkMenu   *menu)
6087 {
6088   GtkLabel *label = GTK_LABEL (attach_widget);
6089   GtkLabelPrivate *priv = label->priv;
6090
6091   if (priv->select_info)
6092     priv->select_info->popup_menu = NULL;
6093 }
6094
6095 static void
6096 popup_position_func (GtkMenu   *menu,
6097                      gint      *x,
6098                      gint      *y,
6099                      gboolean  *push_in,
6100                      gpointer   user_data)
6101 {
6102   GtkLabel *label;
6103   GtkWidget *widget;
6104   GtkAllocation allocation;
6105   GtkRequisition req;
6106   GdkScreen *screen;
6107
6108   label = GTK_LABEL (user_data);
6109   widget = GTK_WIDGET (label);
6110
6111   g_return_if_fail (gtk_widget_get_realized (widget));
6112
6113   screen = gtk_widget_get_screen (widget);
6114   gdk_window_get_origin (gtk_widget_get_window (widget), x, y);
6115
6116   gtk_widget_get_allocation (widget, &allocation);
6117
6118   *x += allocation.x;
6119   *y += allocation.y;
6120
6121   gtk_widget_get_preferred_size (GTK_WIDGET (menu),
6122                                  &req, NULL);
6123
6124   gtk_widget_get_allocation (widget, &allocation);
6125
6126   *x += allocation.width / 2;
6127   *y += allocation.height;
6128
6129   *x = CLAMP (*x, 0, MAX (0, gdk_screen_get_width (screen) - req.width));
6130   *y = CLAMP (*y, 0, MAX (0, gdk_screen_get_height (screen) - req.height));
6131 }
6132
6133 static void
6134 open_link_activate_cb (GtkMenuItem *menu_item,
6135                        GtkLabel    *label)
6136 {
6137   GtkLabelLink *link;
6138
6139   link = gtk_label_get_current_link (label);
6140
6141   if (link)
6142     emit_activate_link (label, link);
6143 }
6144
6145 static void
6146 copy_link_activate_cb (GtkMenuItem *menu_item,
6147                        GtkLabel    *label)
6148 {
6149   GtkClipboard *clipboard;
6150   const gchar *uri;
6151
6152   uri = gtk_label_get_current_uri (label);
6153   if (uri)
6154     {
6155       clipboard = gtk_widget_get_clipboard (GTK_WIDGET (label), GDK_SELECTION_CLIPBOARD);
6156       gtk_clipboard_set_text (clipboard, uri, -1);
6157     }
6158 }
6159
6160 static gboolean
6161 gtk_label_popup_menu (GtkWidget *widget)
6162 {
6163   gtk_label_do_popup (GTK_LABEL (widget), NULL);
6164
6165   return TRUE;
6166 }
6167
6168 static void
6169 gtk_label_do_popup (GtkLabel       *label,
6170                     GdkEventButton *event)
6171 {
6172   GtkLabelPrivate *priv = label->priv;
6173   GtkWidget *menuitem;
6174   GtkWidget *menu;
6175   GtkWidget *image;
6176   gboolean have_selection;
6177   GtkLabelLink *link;
6178
6179   if (!priv->select_info)
6180     return;
6181
6182   if (priv->select_info->popup_menu)
6183     gtk_widget_destroy (priv->select_info->popup_menu);
6184
6185   priv->select_info->popup_menu = menu = gtk_menu_new ();
6186
6187   gtk_menu_attach_to_widget (GTK_MENU (menu), GTK_WIDGET (label), popup_menu_detach);
6188
6189   have_selection =
6190     priv->select_info->selection_anchor != priv->select_info->selection_end;
6191
6192   if (event)
6193     {
6194       if (priv->select_info->link_clicked)
6195         link = priv->select_info->active_link;
6196       else
6197         link = NULL;
6198     }
6199   else
6200     link = gtk_label_get_focus_link (label);
6201
6202   if (!have_selection && link)
6203     {
6204       /* Open Link */
6205       menuitem = gtk_image_menu_item_new_with_mnemonic (_("_Open Link"));
6206       gtk_widget_show (menuitem);
6207       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6208
6209       g_signal_connect (G_OBJECT (menuitem), "activate",
6210                         G_CALLBACK (open_link_activate_cb), label);
6211
6212       image = gtk_image_new_from_stock (GTK_STOCK_JUMP_TO, GTK_ICON_SIZE_MENU);
6213       gtk_widget_show (image);
6214       gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (menuitem), image);
6215
6216       /* Copy Link Address */
6217       menuitem = gtk_image_menu_item_new_with_mnemonic (_("Copy _Link Address"));
6218       gtk_widget_show (menuitem);
6219       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6220
6221       g_signal_connect (G_OBJECT (menuitem), "activate",
6222                         G_CALLBACK (copy_link_activate_cb), label);
6223
6224       image = gtk_image_new_from_stock (GTK_STOCK_COPY, GTK_ICON_SIZE_MENU);
6225       gtk_widget_show (image);
6226       gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (menuitem), image);
6227     }
6228   else
6229     {
6230       append_action_signal (label, menu, GTK_STOCK_CUT, "cut-clipboard", FALSE);
6231       append_action_signal (label, menu, GTK_STOCK_COPY, "copy-clipboard", have_selection);
6232       append_action_signal (label, menu, GTK_STOCK_PASTE, "paste-clipboard", FALSE);
6233
6234       menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_DELETE, NULL);
6235       gtk_widget_set_sensitive (menuitem, FALSE);
6236       gtk_widget_show (menuitem);
6237       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6238
6239       menuitem = gtk_separator_menu_item_new ();
6240       gtk_widget_show (menuitem);
6241       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6242
6243       menuitem = gtk_image_menu_item_new_from_stock (GTK_STOCK_SELECT_ALL, NULL);
6244       g_signal_connect_swapped (menuitem, "activate",
6245                                 G_CALLBACK (gtk_label_select_all), label);
6246       gtk_widget_show (menuitem);
6247       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem);
6248     }
6249
6250   g_signal_emit (label, signals[POPULATE_POPUP], 0, menu);
6251
6252   if (event)
6253     gtk_menu_popup (GTK_MENU (menu), NULL, NULL,
6254                     NULL, NULL,
6255                     event->button, event->time);
6256   else
6257     {
6258       gtk_menu_popup (GTK_MENU (menu), NULL, NULL,
6259                       popup_position_func, label,
6260                       0, gtk_get_current_event_time ());
6261       gtk_menu_shell_select_first (GTK_MENU_SHELL (menu), FALSE);
6262     }
6263 }
6264
6265 static void
6266 gtk_label_clear_links (GtkLabel *label)
6267 {
6268   GtkLabelPrivate *priv = label->priv;
6269
6270   if (!priv->select_info)
6271     return;
6272
6273   g_list_free_full (priv->select_info->links, (GDestroyNotify) link_free);
6274   priv->select_info->links = NULL;
6275   priv->select_info->active_link = NULL;
6276 }
6277
6278 static gboolean
6279 gtk_label_activate_link (GtkLabel    *label,
6280                          const gchar *uri)
6281 {
6282   GtkWidget *widget = GTK_WIDGET (label);
6283   GError *error = NULL;
6284
6285   if (!gtk_show_uri (gtk_widget_get_screen (widget),
6286                      uri, gtk_get_current_event_time (), &error))
6287     {
6288       g_warning ("Unable to show '%s': %s", uri, error->message);
6289       g_error_free (error);
6290     }
6291
6292   return TRUE;
6293 }
6294
6295 static void
6296 emit_activate_link (GtkLabel     *label,
6297                     GtkLabelLink *link)
6298 {
6299   GtkLabelPrivate *priv = label->priv;
6300   gboolean handled;
6301
6302   g_signal_emit (label, signals[ACTIVATE_LINK], 0, link->uri, &handled);
6303   if (handled && priv->track_links && !link->visited)
6304     {
6305       link->visited = TRUE;
6306       /* FIXME: shouldn't have to redo everything here */
6307       gtk_label_clear_layout (label);
6308     }
6309 }
6310
6311 static void
6312 gtk_label_activate_current_link (GtkLabel *label)
6313 {
6314   GtkLabelLink *link;
6315   GtkWidget *widget = GTK_WIDGET (label);
6316
6317   link = gtk_label_get_focus_link (label);
6318
6319   if (link)
6320     {
6321       emit_activate_link (label, link);
6322     }
6323   else
6324     {
6325       GtkWidget *toplevel;
6326       GtkWindow *window;
6327       GtkWidget *default_widget, *focus_widget;
6328
6329       toplevel = gtk_widget_get_toplevel (widget);
6330       if (GTK_IS_WINDOW (toplevel))
6331         {
6332           window = GTK_WINDOW (toplevel);
6333
6334           if (window)
6335             {
6336               default_widget = gtk_window_get_default_widget (window);
6337               focus_widget = gtk_window_get_focus (window);
6338
6339               if (default_widget != widget &&
6340                   !(widget == focus_widget && (!default_widget || !gtk_widget_is_sensitive (default_widget))))
6341                 gtk_window_activate_default (window);
6342             }
6343         }
6344     }
6345 }
6346
6347 static GtkLabelLink *
6348 gtk_label_get_current_link (GtkLabel *label)
6349 {
6350   GtkLabelPrivate *priv = label->priv;
6351   GtkLabelLink *link;
6352
6353   if (!priv->select_info)
6354     return NULL;
6355
6356   if (priv->select_info->link_clicked)
6357     link = priv->select_info->active_link;
6358   else
6359     link = gtk_label_get_focus_link (label);
6360
6361   return link;
6362 }
6363
6364 /**
6365  * gtk_label_get_current_uri:
6366  * @label: a #GtkLabel
6367  *
6368  * Returns the URI for the currently active link in the label.
6369  * The active link is the one under the mouse pointer or, in a
6370  * selectable label, the link in which the text cursor is currently
6371  * positioned.
6372  *
6373  * This function is intended for use in a #GtkLabel::activate-link handler
6374  * or for use in a #GtkWidget::query-tooltip handler.
6375  *
6376  * Returns: the currently active URI. The string is owned by GTK+ and must
6377  *   not be freed or modified.
6378  *
6379  * Since: 2.18
6380  */
6381 const gchar *
6382 gtk_label_get_current_uri (GtkLabel *label)
6383 {
6384   GtkLabelLink *link;
6385
6386   g_return_val_if_fail (GTK_IS_LABEL (label), NULL);
6387
6388   link = gtk_label_get_current_link (label);
6389
6390   if (link)
6391     return link->uri;
6392
6393   return NULL;
6394 }
6395
6396 /**
6397  * gtk_label_set_track_visited_links:
6398  * @label: a #GtkLabel
6399  * @track_links: %TRUE to track visited links
6400  *
6401  * Sets whether the label should keep track of clicked
6402  * links (and use a different color for them).
6403  *
6404  * Since: 2.18
6405  */
6406 void
6407 gtk_label_set_track_visited_links (GtkLabel *label,
6408                                    gboolean  track_links)
6409 {
6410   GtkLabelPrivate *priv;
6411
6412   g_return_if_fail (GTK_IS_LABEL (label));
6413
6414   priv = label->priv;
6415
6416   track_links = track_links != FALSE;
6417
6418   if (priv->track_links != track_links)
6419     {
6420       priv->track_links = track_links;
6421
6422       /* FIXME: shouldn't have to redo everything here */
6423       gtk_label_recalculate (label);
6424
6425       g_object_notify (G_OBJECT (label), "track-visited-links");
6426     }
6427 }
6428
6429 /**
6430  * gtk_label_get_track_visited_links:
6431  * @label: a #GtkLabel
6432  *
6433  * Returns whether the label is currently keeping track
6434  * of clicked links.
6435  *
6436  * Returns: %TRUE if clicked links are remembered
6437  *
6438  * Since: 2.18
6439  */
6440 gboolean
6441 gtk_label_get_track_visited_links (GtkLabel *label)
6442 {
6443   g_return_val_if_fail (GTK_IS_LABEL (label), FALSE);
6444
6445   return label->priv->track_links;
6446 }
6447
6448 static gboolean
6449 gtk_label_query_tooltip (GtkWidget  *widget,
6450                          gint        x,
6451                          gint        y,
6452                          gboolean    keyboard_tip,
6453                          GtkTooltip *tooltip)
6454 {
6455   GtkLabel *label = GTK_LABEL (widget);
6456   GtkLabelPrivate *priv = label->priv;
6457   GtkLabelSelectionInfo *info = priv->select_info;
6458   gint index = -1;
6459   GList *l;
6460
6461   if (info && info->links)
6462     {
6463       if (keyboard_tip)
6464         {
6465           if (info->selection_anchor == info->selection_end)
6466             index = info->selection_anchor;
6467         }
6468       else
6469         {
6470           if (!get_layout_index (label, x, y, &index))
6471             index = -1;
6472         }
6473
6474       if (index != -1)
6475         {
6476           for (l = info->links; l != NULL; l = l->next)
6477             {
6478               GtkLabelLink *link = l->data;
6479               if (index >= link->start && index <= link->end)
6480                 {
6481                   if (link->title)
6482                     {
6483                       gtk_tooltip_set_markup (tooltip, link->title);
6484                       return TRUE;
6485                     }
6486                   break;
6487                 }
6488             }
6489         }
6490     }
6491
6492   return GTK_WIDGET_CLASS (gtk_label_parent_class)->query_tooltip (widget,
6493                                                                    x, y,
6494                                                                    keyboard_tip,
6495                                                                    tooltip);
6496 }
6497
6498 gint
6499 _gtk_label_get_cursor_position (GtkLabel *label)
6500 {
6501   GtkLabelPrivate *priv = label->priv;
6502
6503   if (priv->select_info && priv->select_info->selectable)
6504     return g_utf8_pointer_to_offset (priv->text,
6505                                      priv->text + priv->select_info->selection_end);
6506
6507   return 0;
6508 }
6509
6510 gint
6511 _gtk_label_get_selection_bound (GtkLabel *label)
6512 {
6513   GtkLabelPrivate *priv = label->priv;
6514
6515   if (priv->select_info && priv->select_info->selectable)
6516     return g_utf8_pointer_to_offset (priv->text,
6517                                      priv->text + priv->select_info->selection_anchor);
6518
6519   return 0;
6520 }