← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkLabel.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkLabel.html
49
49
#include <gtk/gtk.h>
50
50
 
51
51
                    <a class="link" href="GtkLabel.html#GtkLabel-struct" title="GtkLabel">GtkLabel</a>;
52
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkLabel.html#gtk-label-new" title="gtk_label_new ()">gtk_label_new</a>                       (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
52
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkLabel.html#gtk-label-new" title="gtk_label_new ()">gtk_label_new</a>                       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
53
53
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-text" title="gtk_label_set_text ()">gtk_label_set_text</a>                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
54
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
54
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
55
55
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()">gtk_label_set_attributes</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
56
56
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>);
57
57
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()">gtk_label_set_markup</a>                (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
58
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
58
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
59
59
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-markup-with-mnemonic" title="gtk_label_set_markup_with_mnemonic ()">gtk_label_set_markup_with_mnemonic</a>  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
60
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
60
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-pattern" title="gtk_label_set_pattern ()">gtk_label_set_pattern</a>               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
62
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);
 
62
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-justify" title="gtk_label_set_justify ()">gtk_label_set_justify</a>               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
64
64
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> jtype</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-ellipsize" title="gtk_label_set_ellipsize ()">gtk_label_set_ellipsize</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
66
66
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> mode</code></em>);
67
67
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()">gtk_label_set_width_chars</a>           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
68
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);
 
68
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-max-width-chars" title="gtk_label_set_max_width_chars ()">gtk_label_set_max_width_chars</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
70
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);
71
71
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-get" title="gtk_label_get ()">gtk_label_get</a>                       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
72
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **str</code></em>);
73
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkLabel.html#gtk-label-parse-uline" title="gtk_label_parse_uline ()">gtk_label_parse_uline</a>               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
74
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **str</code></em>);
 
73
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkLabel.html#gtk-label-parse-uline" title="gtk_label_parse_uline ()">gtk_label_parse_uline</a>               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
 
74
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
75
75
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()">gtk_label_set_line_wrap</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
76
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>);
 
76
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>);
77
77
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap-mode" title="gtk_label_set_line_wrap_mode ()">gtk_label_set_line_wrap_mode</a>        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
78
78
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> wrap_mode</code></em>);
79
79
#define             <a class="link" href="GtkLabel.html#gtk-label-set" title="gtk_label_set">gtk_label_set</a>
80
80
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-get-layout-offsets" title="gtk_label_get_layout_offsets ()">gtk_label_get_layout_offsets</a>        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
81
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
82
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);
83
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkLabel.html#gtk-label-get-mnemonic-keyval" title="gtk_label_get_mnemonic_keyval ()">gtk_label_get_mnemonic_keyval</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
84
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-selectable" title="gtk_label_get_selectable ()">gtk_label_get_selectable</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
85
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkLabel.html#gtk-label-get-text" title="gtk_label_get_text ()">gtk_label_get_text</a>                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
86
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()">gtk_label_new_with_mnemonic</a>         (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
 
82
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);
 
83
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkLabel.html#gtk-label-get-mnemonic-keyval" title="gtk_label_get_mnemonic_keyval ()">gtk_label_get_mnemonic_keyval</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
84
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-selectable" title="gtk_label_get_selectable ()">gtk_label_get_selectable</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
85
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkLabel.html#gtk-label-get-text" title="gtk_label_get_text ()">gtk_label_get_text</a>                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
86
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()">gtk_label_new_with_mnemonic</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
87
87
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-select-region" title="gtk_label_select_region ()">gtk_label_select_region</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
88
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>,
89
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>);
 
88
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>,
 
89
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>);
90
90
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()">gtk_label_set_mnemonic_widget</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
91
91
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
92
92
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()">gtk_label_set_selectable</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
93
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
 
93
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
94
94
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-text-with-mnemonic" title="gtk_label_set_text_with_mnemonic ()">gtk_label_set_text_with_mnemonic</a>    (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
95
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
95
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
96
96
<a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     <a class="link" href="GtkLabel.html#gtk-label-get-attributes" title="gtk_label_get_attributes ()">gtk_label_get_attributes</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
97
97
<a class="link" href="gtk-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="returnvalue">GtkJustification</span></a>    <a class="link" href="GtkLabel.html#gtk-label-get-justify" title="gtk_label_get_justify ()">gtk_label_get_justify</a>               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
98
98
<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="returnvalue">PangoEllipsizeMode</span></a>  <a class="link" href="GtkLabel.html#gtk-label-get-ellipsize" title="gtk_label_get_ellipsize ()">gtk_label_get_ellipsize</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
99
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkLabel.html#gtk-label-get-width-chars" title="gtk_label_get_width_chars ()">gtk_label_get_width_chars</a>           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
100
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkLabel.html#gtk-label-get-max-width-chars" title="gtk_label_get_max_width_chars ()">gtk_label_get_max_width_chars</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
101
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkLabel.html#gtk-label-get-label" title="gtk_label_get_label ()">gtk_label_get_label</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
99
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkLabel.html#gtk-label-get-width-chars" title="gtk_label_get_width_chars ()">gtk_label_get_width_chars</a>           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
100
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkLabel.html#gtk-label-get-max-width-chars" title="gtk_label_get_max_width_chars ()">gtk_label_get_max_width_chars</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
101
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkLabel.html#gtk-label-get-label" title="gtk_label_get_label ()">gtk_label_get_label</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
102
102
<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> *       <a class="link" href="GtkLabel.html#gtk-label-get-layout" title="gtk_label_get_layout ()">gtk_label_get_layout</a>                (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
103
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-line-wrap" title="gtk_label_get_line_wrap ()">gtk_label_get_line_wrap</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
103
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-line-wrap" title="gtk_label_get_line_wrap ()">gtk_label_get_line_wrap</a>             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
104
104
<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="returnvalue">PangoWrapMode</span></a>       <a class="link" href="GtkLabel.html#gtk-label-get-line-wrap-mode" title="gtk_label_get_line_wrap_mode ()">gtk_label_get_line_wrap_mode</a>        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
105
105
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkLabel.html#gtk-label-get-mnemonic-widget" title="gtk_label_get_mnemonic_widget ()">gtk_label_get_mnemonic_widget</a>       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
106
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-selection-bounds" title="gtk_label_get_selection_bounds ()">gtk_label_get_selection_bounds</a>      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
107
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
108
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);
109
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-use-markup" title="gtk_label_get_use_markup ()">gtk_label_get_use_markup</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
110
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-use-underline" title="gtk_label_get_use_underline ()">gtk_label_get_use_underline</a>         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
111
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-single-line-mode" title="gtk_label_get_single_line_mode ()">gtk_label_get_single_line_mode</a>      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
112
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="GtkLabel.html#gtk-label-get-angle" title="gtk_label_get_angle ()">gtk_label_get_angle</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
106
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-selection-bounds" title="gtk_label_get_selection_bounds ()">gtk_label_get_selection_bounds</a>      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
 
107
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
 
108
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);
 
109
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-use-markup" title="gtk_label_get_use_markup ()">gtk_label_get_use_markup</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-use-underline" title="gtk_label_get_use_underline ()">gtk_label_get_use_underline</a>         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
111
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-single-line-mode" title="gtk_label_get_single_line_mode ()">gtk_label_get_single_line_mode</a>      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
112
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="GtkLabel.html#gtk-label-get-angle" title="gtk_label_get_angle ()">gtk_label_get_angle</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
113
113
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-label" title="gtk_label_set_label ()">gtk_label_set_label</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
114
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
114
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
115
115
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-use-markup" title="gtk_label_set_use_markup ()">gtk_label_set_use_markup</a>            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
116
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
 
116
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
117
117
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-use-underline" title="gtk_label_set_use_underline ()">gtk_label_set_use_underline</a>         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
118
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
 
118
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
119
119
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-single-line-mode" title="gtk_label_set_single_line_mode ()">gtk_label_set_single_line_mode</a>      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
120
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>);
 
120
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>);
121
121
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-angle" title="gtk_label_set_angle ()">gtk_label_set_angle</a>                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
122
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>);
123
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkLabel.html#gtk-label-get-current-uri" title="gtk_label_get_current_uri ()">gtk_label_get_current_uri</a>           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
122
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>);
 
123
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkLabel.html#gtk-label-get-current-uri" title="gtk_label_get_current_uri ()">gtk_label_get_current_uri</a>           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
124
124
<span class="returnvalue">void</span>                <a class="link" href="GtkLabel.html#gtk-label-set-track-visited-links" title="gtk_label_set_track_visited_links ()">gtk_label_set_track_visited_links</a>   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
125
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>);
126
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-track-visited-links" title="gtk_label_get_track_visited_links ()">gtk_label_get_track_visited_links</a>   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
 
125
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>);
 
126
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkLabel.html#gtk-label-get-track-visited-links" title="gtk_label_get_track_visited_links ()">gtk_label_get_track_visited_links</a>   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);
127
127
</pre>
128
128
</div>
129
129
<div class="refsect1" title="Object Hierarchy">
130
130
<a name="GtkLabel.object-hierarchy"></a><h2>Object Hierarchy</h2>
131
131
<pre class="synopsis">
132
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
133
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
132
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
133
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
134
134
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
135
135
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
136
136
                     +----<a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>
148
148
<div class="refsect1" title="Properties">
149
149
<a name="GtkLabel.properties"></a><h2>Properties</h2>
150
150
<pre class="synopsis">
151
 
  "<a class="link" href="GtkLabel.html#GtkLabel--angle" title='The "angle" property'>angle</a>"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write
 
151
  "<a class="link" href="GtkLabel.html#GtkLabel--angle" title='The "angle" property'>angle</a>"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write
152
152
  "<a class="link" href="GtkLabel.html#GtkLabel--attributes" title='The "attributes" property'>attributes</a>"               <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>*        : Read / Write
153
 
  "<a class="link" href="GtkLabel.html#GtkLabel--cursor-position" title='The "cursor-position" property'>cursor-position</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
153
  "<a class="link" href="GtkLabel.html#GtkLabel--cursor-position" title='The "cursor-position" property'>cursor-position</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
154
154
  "<a class="link" href="GtkLabel.html#GtkLabel--ellipsize" title='The "ellipsize" property'>ellipsize</a>"                <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a>    : Read / Write
155
155
  "<a class="link" href="GtkLabel.html#GtkLabel--justify" title='The "justify" property'>justify</a>"                  <a class="link" href="gtk-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a>      : Read / Write
156
 
  "<a class="link" href="GtkLabel.html#GtkLabel--label" title='The "label" property'>label</a>"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
157
 
  "<a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'>max-width-chars</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
158
 
  "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-keyval" title='The "mnemonic-keyval" property'>mnemonic-keyval</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
 
156
  "<a class="link" href="GtkLabel.html#GtkLabel--label" title='The "label" property'>label</a>"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
157
  "<a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'>max-width-chars</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
158
  "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-keyval" title='The "mnemonic-keyval" property'>mnemonic-keyval</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
159
159
  "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-widget" title='The "mnemonic-widget" property'>mnemonic-widget</a>"          <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
160
 
  "<a class="link" href="GtkLabel.html#GtkLabel--pattern" title='The "pattern" property'>pattern</a>"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write
161
 
  "<a class="link" href="GtkLabel.html#GtkLabel--selectable" title='The "selectable" property'>selectable</a>"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
162
 
  "<a class="link" href="GtkLabel.html#GtkLabel--selection-bound" title='The "selection-bound" property'>selection-bound</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
163
 
  "<a class="link" href="GtkLabel.html#GtkLabel--single-line-mode" title='The "single-line-mode" property'>single-line-mode</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
164
 
  "<a class="link" href="GtkLabel.html#GtkLabel--track-visited-links" title='The "track-visited-links" property'>track-visited-links</a>"      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
165
 
  "<a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'>use-markup</a>"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
166
 
  "<a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'>use-underline</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
167
 
  "<a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'>width-chars</a>"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
168
 
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'>wrap</a>"                     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
160
  "<a class="link" href="GtkLabel.html#GtkLabel--pattern" title='The "pattern" property'>pattern</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write
 
161
  "<a class="link" href="GtkLabel.html#GtkLabel--selectable" title='The "selectable" property'>selectable</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
162
  "<a class="link" href="GtkLabel.html#GtkLabel--selection-bound" title='The "selection-bound" property'>selection-bound</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
163
  "<a class="link" href="GtkLabel.html#GtkLabel--single-line-mode" title='The "single-line-mode" property'>single-line-mode</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
164
  "<a class="link" href="GtkLabel.html#GtkLabel--track-visited-links" title='The "track-visited-links" property'>track-visited-links</a>"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
165
  "<a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'>use-markup</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
166
  "<a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'>use-underline</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
167
  "<a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'>width-chars</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
168
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'>wrap</a>"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
169
169
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap-mode" title='The "wrap-mode" property'>wrap-mode</a>"                <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a>         : Read / Write
170
170
</pre>
171
171
</div>
195
195
start and end and allows you to specify <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> values for this label.
196
196
</p>
197
197
<div class="example">
198
 
<a name="id718146"></a><p class="title"><b>Example 13. A UI definition fragment specifying Pango attributes</b></p>
 
198
<a name="id632246"></a><p class="title"><b>Example 13. A UI definition fragment specifying Pango attributes</b></p>
199
199
<div class="example-contents">
200
200
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
201
201
    <tbody>
206
206
4
207
207
5
208
208
6</pre></td>
209
 
        <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="normal">object class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="symbol">&gt;</span>
 
209
        <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="symbol">&gt;</span>
210
210
<span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">attributes</span><span class="symbol">&gt;</span>
211
 
<span class="normal">    </span><span class="symbol">&lt;</span><span class="normal">attribute name</span><span class="symbol">=</span><span class="string">"weight"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"PANGO_WEIGHT_BOLD"</span><span class="symbol">/&gt;</span>
212
 
<span class="normal">    </span><span class="symbol">&lt;</span><span class="normal">attribute name</span><span class="symbol">=</span><span class="string">"background"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"red"</span><span class="normal"> start</span><span class="symbol">=</span><span class="string">"5"</span><span class="normal"> end</span><span class="symbol">=</span><span class="string">"10"</span><span class="symbol">/&gt;</span><span class="string">"</span>
 
211
<span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"weight"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"PANGO_WEIGHT_BOLD"</span><span class="symbol">/&gt;</span>
 
212
<span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"background"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"red"</span><span class="normal"> start</span><span class="symbol">=</span><span class="string">"5"</span><span class="normal"> end</span><span class="symbol">=</span><span class="string">"10"</span><span class="symbol">/&gt;</span><span class="string">"</span>
213
213
<span class="string">  &lt;/attributes&gt;</span>
214
214
<span class="string">&lt;/object&gt;</span></pre></td>
215
215
      </tr>
228
228
</div>
229
229
<hr>
230
230
<div class="refsect2" title="Mnemonics">
231
 
<a name="id718169"></a><h3>Mnemonics</h3>
 
231
<a name="id632269"></a><h3>Mnemonics</h3>
232
232
<p>
233
233
Labels may contain <em class="firstterm">mnemonics</em>. Mnemonics are
234
234
underlined characters in the label, used for keyboard navigation.
305
305
</div>
306
306
<hr>
307
307
<div class="refsect2" title="Markup (styled text)">
308
 
<a name="id718290"></a><h3>Markup (styled text)</h3>
 
308
<a name="id632391"></a><h3>Markup (styled text)</h3>
309
309
<p>
310
310
To make it easy to format text in a label (changing colors, fonts,
311
311
etc.), label text can be provided in a simple <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">markup format</a>.
317
317
      <tr>
318
318
        <td class="listing_lines" align="right"><pre>1
319
319
2</pre></td>
320
 
        <td class="listing_code"><pre class="programlisting"><span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
320
        <td class="listing_code"><pre class="programlisting"><span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
321
321
<span class="function"><a href="GtkLabel.html#gtk-label-set-markup">gtk_label_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"&lt;small&gt;Small text&lt;/small&gt;"</span><span class="symbol">);</span></pre></td>
322
322
      </tr>
323
323
    </tbody>
333
333
literal &lt;/&gt;/&amp; characters must be escaped as &amp;lt;,
334
334
&amp;gt;, and &amp;amp;. If you pass text obtained from the user, file,
335
335
or a network to <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>, you'll want to escape it with
336
 
<a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>.
 
336
<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>.
337
337
</p>
338
338
<p>
339
339
Markup strings are just a convenient way to set the <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> on
348
348
</div>
349
349
<hr>
350
350
<div class="refsect2" title="Selectable labels">
351
 
<a name="id718408"></a><h3>Selectable labels</h3>
 
351
<a name="id632508"></a><h3>Selectable labels</h3>
352
352
<p>
353
353
Labels can be made selectable with <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>.
354
354
Selectable labels allow the user to copy the label contents to
358
358
</div>
359
359
<hr>
360
360
<div class="refsect2" title="Text layout">
361
 
<a name="id718431"></a><h3>Text layout</h3>
 
361
<a name="id632531"></a><h3>Text layout</h3>
362
362
<p>
363
363
A label can contain any number of paragraphs, but will have
364
364
performance problems if it contains more than a small number.
377
377
</div>
378
378
<hr>
379
379
<div class="refsect2" title="Links">
380
 
<a name="id718482"></a><h3>Links</h3>
 
380
<a name="id632582"></a><h3>Links</h3>
381
381
<p>
382
382
Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
383
383
to regular Pango markup. The markup for links is borrowed from HTML, using the
415
415
<hr>
416
416
<div class="refsect2" title="gtk_label_new ()">
417
417
<a name="gtk-label-new"></a><h3>gtk_label_new ()</h3>
418
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_label_new                       (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
418
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_label_new                       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
419
419
<p>
420
420
Creates a new label with the given text inside it. You can
421
 
pass <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to get an empty label widget.
 
421
pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to get an empty label widget.
422
422
</p>
423
423
<div class="variablelist"><table border="0">
424
424
<col align="left" valign="top">
440
440
<div class="refsect2" title="gtk_label_set_text ()">
441
441
<a name="gtk-label-set-text"></a><h3>gtk_label_set_text ()</h3>
442
442
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_text                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
443
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
443
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
444
444
<p>
445
445
Sets the text within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. It overwrites any text that
446
446
was there before.  
506
506
<div class="refsect2" title="gtk_label_set_markup ()">
507
507
<a name="gtk-label-set-markup"></a><h3>gtk_label_set_markup ()</h3>
508
508
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_markup                (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
509
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
509
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
510
510
<p>
511
511
Parses <em class="parameter"><code>str</code></em> which is marked up with the <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>, setting the
512
512
label's text and attribute list based on the parse results. If the <em class="parameter"><code>str</code></em> is
513
 
external data, you may need to escape it with <a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or
514
 
<a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>:
 
513
external data, you may need to escape it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or
 
514
<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>:
515
515
</p>
516
516
<div class="informalexample">
517
517
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
524
524
5</pre></td>
525
525
        <td class="listing_code"><pre class="programlisting"><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">markup</span><span class="symbol">;</span>
526
526
<span class="normal">  </span>
527
 
<span class="normal">markup </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"&lt;span style=</span><span class="specialchar">\"</span><span class="string">italic</span><span class="specialchar">\"</span><span class="string">&gt;%s&lt;/span&gt;"</span><span class="symbol">,</span><span class="normal"> str</span><span class="symbol">);</span>
 
527
<span class="normal">markup </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"&lt;span style=</span><span class="specialchar">\"</span><span class="string">italic</span><span class="specialchar">\"</span><span class="string">&gt;%s&lt;/span&gt;"</span><span class="symbol">,</span><span class="normal"> str</span><span class="symbol">);</span>
528
528
<span class="function"><a href="GtkLabel.html#gtk-label-set-markup">gtk_label_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> markup</span><span class="symbol">);</span>
529
 
<span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">markup</span><span class="symbol">);</span></pre></td>
 
529
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">markup</span><span class="symbol">);</span></pre></td>
530
530
      </tr>
531
531
    </tbody>
532
532
  </table>
554
554
<div class="refsect2" title="gtk_label_set_markup_with_mnemonic ()">
555
555
<a name="gtk-label-set-markup-with-mnemonic"></a><h3>gtk_label_set_markup_with_mnemonic ()</h3>
556
556
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_markup_with_mnemonic  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
557
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
557
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
558
558
<p>
559
559
Parses <em class="parameter"><code>str</code></em> which is marked up with the <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>,
560
560
setting the label's text and attribute list based on the parse results.
585
585
<div class="refsect2" title="gtk_label_set_pattern ()">
586
586
<a name="gtk-label-set-pattern"></a><h3>gtk_label_set_pattern ()</h3>
587
587
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_pattern               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
588
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);</pre>
 
588
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);</pre>
589
589
<p>
590
590
The pattern of underlines you want under the existing text within the
591
591
<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget.  For example if the current text of the label says
667
667
<div class="refsect2" title="gtk_label_set_width_chars ()">
668
668
<a name="gtk-label-set-width-chars"></a><h3>gtk_label_set_width_chars ()</h3>
669
669
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_width_chars           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
670
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre>
 
670
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre>
671
671
<p>
672
672
Sets the desired width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>.
673
673
</p>
692
692
<div class="refsect2" title="gtk_label_set_max_width_chars ()">
693
693
<a name="gtk-label-set-max-width-chars"></a><h3>gtk_label_set_max_width_chars ()</h3>
694
694
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_max_width_chars       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
695
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre>
 
695
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre>
696
696
<p>
697
697
Sets the desired maximum width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>.
698
698
</p>
717
717
<div class="refsect2" title="gtk_label_get ()">
718
718
<a name="gtk-label-get"></a><h3>gtk_label_get ()</h3>
719
719
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_get                       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
720
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **str</code></em>);</pre>
 
720
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **str</code></em>);</pre>
721
721
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
722
722
<h3 class="title">Warning</h3>
723
723
<p><code class="literal">gtk_label_get</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkLabel.html#gtk-label-get-text" title="gtk_label_get_text ()"><code class="function">gtk_label_get_text()</code></a> instead.</p>
746
746
<hr>
747
747
<div class="refsect2" title="gtk_label_parse_uline ()">
748
748
<a name="gtk-label-parse-uline"></a><h3>gtk_label_parse_uline ()</h3>
749
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_label_parse_uline               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
750
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
749
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_label_parse_uline               (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
 
750
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
751
751
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
752
752
<h3 class="title">Warning</h3>
753
753
<p><code class="literal">gtk_label_parse_uline</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkLabel.html#gtk-label-set-use-underline" title="gtk_label_set_use_underline ()"><code class="function">gtk_label_set_use_underline()</code></a> instead.</p>
784
784
<div class="refsect2" title="gtk_label_set_line_wrap ()">
785
785
<a name="gtk-label-set-line-wrap"></a><h3>gtk_label_set_line_wrap ()</h3>
786
786
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_line_wrap             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
787
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>);</pre>
 
787
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>);</pre>
788
788
<p>
789
 
Toggles line wrapping within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> makes it break
790
 
lines if text exceeds the widget's size. <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> lets the text get cut off
 
789
Toggles line wrapping within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> makes it break
 
790
lines if text exceeds the widget's size. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> lets the text get cut off
791
791
by the edge of the widget if it exceeds the widget size.
792
792
</p>
793
793
<p>
794
 
Note that setting line wrapping to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> does not make the label
 
794
Note that setting line wrapping to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> does not make the label
795
795
wrap at its parent container's width, because GTK+ widgets
796
796
conceptually can't make their requisition depend on the parent
797
797
container's size. For a label that wraps at a specific position,
857
857
<div class="refsect2" title="gtk_label_get_layout_offsets ()">
858
858
<a name="gtk-label-get-layout-offsets"></a><h3>gtk_label_get_layout_offsets ()</h3>
859
859
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_get_layout_offsets        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
860
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
861
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre>
 
860
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
 
861
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre>
862
862
<p>
863
863
Obtains the coordinates where the label will draw the <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
864
864
representing the text in the label; useful to convert mouse events
879
879
</tr>
880
880
<tr>
881
881
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
882
 
<td> location to store X offset of layout, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
882
<td> location to store X offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
883
883
</td>
884
884
</tr>
885
885
<tr>
886
886
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
887
 
<td> location to store Y offset of layout, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
887
<td> location to store Y offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
888
888
</td>
889
889
</tr>
890
890
</tbody>
893
893
<hr>
894
894
<div class="refsect2" title="gtk_label_get_mnemonic_keyval ()">
895
895
<a name="gtk-label-get-mnemonic-keyval"></a><h3>gtk_label_get_mnemonic_keyval ()</h3>
896
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_label_get_mnemonic_keyval       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
896
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_label_get_mnemonic_keyval       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
897
897
<p>
898
898
If the label has been set so that it has an mnemonic key this function
899
899
returns the keyval used for the mnemonic accelerator. If there is no
918
918
<hr>
919
919
<div class="refsect2" title="gtk_label_get_selectable ()">
920
920
<a name="gtk-label-get-selectable"></a><h3>gtk_label_get_selectable ()</h3>
921
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_selectable            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
921
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_selectable            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
922
922
<p>
923
923
Gets the value set by <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>.
924
924
</p>
932
932
</tr>
933
933
<tr>
934
934
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
935
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user can copy text from the label
 
935
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user can copy text from the label
936
936
</td>
937
937
</tr>
938
938
</tbody>
941
941
<hr>
942
942
<div class="refsect2" title="gtk_label_get_text ()">
943
943
<a name="gtk-label-get-text"></a><h3>gtk_label_get_text ()</h3>
944
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_label_get_text                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
944
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_label_get_text                  (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
945
945
<p>
946
946
Fetches the text from a label widget, as displayed on the
947
947
screen. This does not include any embedded underlines
967
967
<hr>
968
968
<div class="refsect2" title="gtk_label_new_with_mnemonic ()">
969
969
<a name="gtk-label-new-with-mnemonic"></a><h3>gtk_label_new_with_mnemonic ()</h3>
970
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_label_new_with_mnemonic         (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
970
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_label_new_with_mnemonic         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
971
971
<p>
972
972
Creates a new <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, containing the text in <em class="parameter"><code>str</code></em>.
973
973
</p>
1007
1007
<div class="refsect2" title="gtk_label_select_region ()">
1008
1008
<a name="gtk-label-select-region"></a><h3>gtk_label_select_region ()</h3>
1009
1009
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_select_region             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1010
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>,
1011
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>);</pre>
 
1010
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>,
 
1011
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>);</pre>
1012
1012
<p>
1013
1013
Selects a range of characters in the label, if the label is selectable.
1014
1014
See <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>. If the label is not selectable,
1078
1078
<div class="refsect2" title="gtk_label_set_selectable ()">
1079
1079
<a name="gtk-label-set-selectable"></a><h3>gtk_label_set_selectable ()</h3>
1080
1080
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_selectable            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1081
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
 
1081
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
1082
1082
<p>
1083
1083
Selectable labels allow the user to select text from the label, for
1084
1084
copy-and-paste.
1094
1094
<tr>
1095
1095
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1096
1096
<td>
1097
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to allow selecting text in the label
 
1097
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to allow selecting text in the label
1098
1098
</td>
1099
1099
</tr>
1100
1100
</tbody>
1104
1104
<div class="refsect2" title="gtk_label_set_text_with_mnemonic ()">
1105
1105
<a name="gtk-label-set-text-with-mnemonic"></a><h3>gtk_label_set_text_with_mnemonic ()</h3>
1106
1106
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_text_with_mnemonic    (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1107
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
1107
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
1108
1108
<p>
1109
1109
Sets the label's text from the string <em class="parameter"><code>str</code></em>.
1110
1110
If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are underlined
1150
1150
</tr>
1151
1151
<tr>
1152
1152
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1153
 
<td> the attribute list, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none was set.
 
1153
<td> the attribute list, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none was set.
1154
1154
</td>
1155
1155
</tr>
1156
1156
</tbody>
1207
1207
<hr>
1208
1208
<div class="refsect2" title="gtk_label_get_width_chars ()">
1209
1209
<a name="gtk-label-get-width-chars"></a><h3>gtk_label_get_width_chars ()</h3>
1210
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_label_get_width_chars           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1210
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_label_get_width_chars           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1211
1211
<p>
1212
1212
Retrieves the desired width of <em class="parameter"><code>label</code></em>, in characters. See
1213
1213
<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>.
1233
1233
<hr>
1234
1234
<div class="refsect2" title="gtk_label_get_max_width_chars ()">
1235
1235
<a name="gtk-label-get-max-width-chars"></a><h3>gtk_label_get_max_width_chars ()</h3>
1236
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_label_get_max_width_chars       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1236
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_label_get_max_width_chars       (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1237
1237
<p>
1238
1238
Retrieves the desired maximum width of <em class="parameter"><code>label</code></em>, in characters. See
1239
1239
<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>.
1259
1259
<hr>
1260
1260
<div class="refsect2" title="gtk_label_get_label ()">
1261
1261
<a name="gtk-label-get-label"></a><h3>gtk_label_get_label ()</h3>
1262
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_label_get_label                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1262
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_label_get_label                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1263
1263
<p>
1264
1264
Fetches the text from a label widget including any embedded
1265
1265
underlines indicating mnemonics and Pango markup. (See
1312
1312
<hr>
1313
1313
<div class="refsect2" title="gtk_label_get_line_wrap ()">
1314
1314
<a name="gtk-label-get-line-wrap"></a><h3>gtk_label_get_line_wrap ()</h3>
1315
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_line_wrap             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1315
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_line_wrap             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1316
1316
<p>
1317
1317
Returns whether lines in the label are automatically wrapped. 
1318
1318
See <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()"><code class="function">gtk_label_set_line_wrap()</code></a>.
1327
1327
</tr>
1328
1328
<tr>
1329
1329
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1330
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.
 
1330
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.
1331
1331
</td>
1332
1332
</tr>
1333
1333
</tbody>
1350
1350
</tr>
1351
1351
<tr>
1352
1352
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1353
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.
 
1353
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.
1354
1354
 
1355
1355
</td>
1356
1356
</tr>
1376
1376
</tr>
1377
1377
<tr>
1378
1378
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1379
 
<td> the target of the label's mnemonic, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none
 
1379
<td> the target of the label's mnemonic, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none
1380
1380
              has been set and the default algorithm will be used.
1381
1381
</td>
1382
1382
</tr>
1386
1386
<hr>
1387
1387
<div class="refsect2" title="gtk_label_get_selection_bounds ()">
1388
1388
<a name="gtk-label-get-selection-bounds"></a><h3>gtk_label_get_selection_bounds ()</h3>
1389
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_selection_bounds      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1390
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
1391
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);</pre>
 
1389
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_selection_bounds      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
 
1390
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>,
 
1391
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);</pre>
1392
1392
<p>
1393
 
Gets the selected range of characters in the label, returning <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
 
1393
Gets the selected range of characters in the label, returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
1394
1394
if there's a selection.
1395
1395
</p>
1396
1396
<div class="variablelist"><table border="0">
1413
1413
</tr>
1414
1414
<tr>
1415
1415
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1416
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if selection is non-empty
 
1416
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if selection is non-empty
1417
1417
</td>
1418
1418
</tr>
1419
1419
</tbody>
1422
1422
<hr>
1423
1423
<div class="refsect2" title="gtk_label_get_use_markup ()">
1424
1424
<a name="gtk-label-get-use-markup"></a><h3>gtk_label_get_use_markup ()</h3>
1425
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_use_markup            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1425
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_use_markup            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1426
1426
<p>
1427
1427
Returns whether the label's text is interpreted as marked up with
1428
1428
the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup
1438
1438
</tr>
1439
1439
<tr>
1440
1440
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1441
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text will be parsed for markup.
 
1441
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text will be parsed for markup.
1442
1442
</td>
1443
1443
</tr>
1444
1444
</tbody>
1447
1447
<hr>
1448
1448
<div class="refsect2" title="gtk_label_get_use_underline ()">
1449
1449
<a name="gtk-label-get-use-underline"></a><h3>gtk_label_get_use_underline ()</h3>
1450
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_use_underline         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1450
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_use_underline         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1451
1451
<p>
1452
1452
Returns whether an embedded underline in the label indicates a
1453
1453
mnemonic. See <a class="link" href="GtkLabel.html#gtk-label-set-use-underline" title="gtk_label_set_use_underline ()"><code class="function">gtk_label_set_use_underline()</code></a>.
1462
1462
</tr>
1463
1463
<tr>
1464
1464
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1465
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> whether an embedded underline in the label indicates
 
1465
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> whether an embedded underline in the label indicates
1466
1466
              the mnemonic accelerator keys.
1467
1467
</td>
1468
1468
</tr>
1472
1472
<hr>
1473
1473
<div class="refsect2" title="gtk_label_get_single_line_mode ()">
1474
1474
<a name="gtk-label-get-single-line-mode"></a><h3>gtk_label_get_single_line_mode ()</h3>
1475
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_single_line_mode      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1475
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_single_line_mode      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1476
1476
<p>
1477
1477
Returns whether the label is in single line mode.
1478
1478
</p>
1486
1486
</tr>
1487
1487
<tr>
1488
1488
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1489
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the label is in single line mode.
 
1489
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the label is in single line mode.
1490
1490
 
1491
1491
</td>
1492
1492
</tr>
1497
1497
<hr>
1498
1498
<div class="refsect2" title="gtk_label_get_angle ()">
1499
1499
<a name="gtk-label-get-angle"></a><h3>gtk_label_get_angle ()</h3>
1500
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gtk_label_get_angle                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1500
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gtk_label_get_angle                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1501
1501
<p>
1502
1502
Gets the angle of rotation for the label. See
1503
1503
<a class="link" href="GtkLabel.html#gtk-label-set-angle" title="gtk_label_set_angle ()"><code class="function">gtk_label_set_angle()</code></a>.
1524
1524
<div class="refsect2" title="gtk_label_set_label ()">
1525
1525
<a name="gtk-label-set-label"></a><h3>gtk_label_set_label ()</h3>
1526
1526
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_label                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1527
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
1527
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
1528
1528
<p>
1529
1529
Sets the text of the label. The label is interpreted as
1530
1530
including embedded underlines and/or Pango markup depending
1551
1551
<div class="refsect2" title="gtk_label_set_use_markup ()">
1552
1552
<a name="gtk-label-set-use-markup"></a><h3>gtk_label_set_use_markup ()</h3>
1553
1553
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_use_markup            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1554
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
 
1554
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
1555
1555
<p>
1556
1556
Sets whether the text of the label contains markup in <GTKDOCLINK HREF="PangoMarkupFormat">Pango's text markup
1557
1557
language</GTKDOCLINK>. See <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>.
1567
1567
<tr>
1568
1568
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1569
1569
<td>
1570
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text should be parsed for markup.
 
1570
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text should be parsed for markup.
1571
1571
</td>
1572
1572
</tr>
1573
1573
</tbody>
1577
1577
<div class="refsect2" title="gtk_label_set_use_underline ()">
1578
1578
<a name="gtk-label-set-use-underline"></a><h3>gtk_label_set_use_underline ()</h3>
1579
1579
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_use_underline         (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1580
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
 
1580
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
1581
1581
<p>
1582
1582
If true, an underline in the text indicates the next character should be
1583
1583
used for the mnemonic accelerator key.
1593
1593
<tr>
1594
1594
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1595
1595
<td>
1596
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics
 
1596
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics
1597
1597
</td>
1598
1598
</tr>
1599
1599
</tbody>
1603
1603
<div class="refsect2" title="gtk_label_set_single_line_mode ()">
1604
1604
<a name="gtk-label-set-single-line-mode"></a><h3>gtk_label_set_single_line_mode ()</h3>
1605
1605
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_single_line_mode      (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1606
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>);</pre>
 
1606
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>);</pre>
1607
1607
<p>
1608
1608
Sets whether the label is in single line mode.
1609
1609
</p>
1618
1618
<tr>
1619
1619
<td><p><span class="term"><em class="parameter"><code>single_line_mode</code></em> :</span></p></td>
1620
1620
<td>
1621
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label should be in single line mode
 
1621
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label should be in single line mode
1622
1622
</td>
1623
1623
</tr>
1624
1624
</tbody>
1629
1629
<div class="refsect2" title="gtk_label_set_angle ()">
1630
1630
<a name="gtk-label-set-angle"></a><h3>gtk_label_set_angle ()</h3>
1631
1631
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_angle                 (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1632
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>);</pre>
 
1632
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>);</pre>
1633
1633
<p>
1634
1634
Sets the angle of rotation for the label. An angle of 90 reads from
1635
1635
from bottom to top, an angle of 270, from top to bottom. The angle
1657
1657
<hr>
1658
1658
<div class="refsect2" title="gtk_label_get_current_uri ()">
1659
1659
<a name="gtk-label-get-current-uri"></a><h3>gtk_label_get_current_uri ()</h3>
1660
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_label_get_current_uri           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1660
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_label_get_current_uri           (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1661
1661
<p>
1662
1662
Returns the URI for the currently active link in the label.
1663
1663
The active link is the one under the mouse pointer or, in a
1691
1691
<div class="refsect2" title="gtk_label_set_track_visited_links ()">
1692
1692
<a name="gtk-label-set-track-visited-links"></a><h3>gtk_label_set_track_visited_links ()</h3>
1693
1693
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_track_visited_links   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
1694
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>);</pre>
 
1694
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>);</pre>
1695
1695
<p>
1696
1696
Sets whether the label should keep track of clicked
1697
1697
links (and use a different color for them).
1707
1707
<tr>
1708
1708
<td><p><span class="term"><em class="parameter"><code>track_links</code></em> :</span></p></td>
1709
1709
<td>
1710
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to track visited links
 
1710
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to track visited links
1711
1711
</td>
1712
1712
</tr>
1713
1713
</tbody>
1717
1717
<hr>
1718
1718
<div class="refsect2" title="gtk_label_get_track_visited_links ()">
1719
1719
<a name="gtk-label-get-track-visited-links"></a><h3>gtk_label_get_track_visited_links ()</h3>
1720
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_track_visited_links   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1720
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_label_get_track_visited_links   (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1721
1721
<p>
1722
1722
Returns whether the label is currently keeping track
1723
1723
of clicked links.
1732
1732
</tr>
1733
1733
<tr>
1734
1734
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1735
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if clicked links are remembered
 
1735
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if clicked links are remembered
1736
1736
 
1737
1737
</td>
1738
1738
</tr>
1745
1745
<a name="GtkLabel.property-details"></a><h2>Property Details</h2>
1746
1746
<div class="refsect2" title='The "angle" property'>
1747
1747
<a name="GtkLabel--angle"></a><h3>The <code class="literal">"angle"</code> property</h3>
1748
 
<pre class="programlisting">  "angle"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write</pre>
 
1748
<pre class="programlisting">  "angle"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write</pre>
1749
1749
<p>
1750
1750
The angle that the baseline of the label makes with the horizontal,
1751
1751
in degrees, measured counterclockwise. An angle of 90 reads from
1765
1765
<hr>
1766
1766
<div class="refsect2" title='The "cursor-position" property'>
1767
1767
<a name="GtkLabel--cursor-position"></a><h3>The <code class="literal">"cursor-position"</code> property</h3>
1768
 
<pre class="programlisting">  "cursor-position"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1768
<pre class="programlisting">  "cursor-position"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1769
1769
<p>The current position of the insertion cursor in chars.</p>
1770
1770
<p>Allowed values: &gt;= 0</p>
1771
1771
<p>Default value: 0</p>
1784
1784
<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a> has the side-effect that the label requests 
1785
1785
only enough space to display the ellipsis "...". In particular, this 
1786
1786
means that ellipsizing labels do not work well in notebook tabs, unless 
1787
 
the tab's <span class="type">"tab-expand"</span> property is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Other ways
 
1787
the tab's <span class="type">"tab-expand"</span> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Other ways
1788
1788
to set a label's width are <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a> and
1789
1789
<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>.
1790
1790
</p>
1801
1801
<hr>
1802
1802
<div class="refsect2" title='The "label" property'>
1803
1803
<a name="GtkLabel--label"></a><h3>The <code class="literal">"label"</code> property</h3>
1804
 
<pre class="programlisting">  "label"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1804
<pre class="programlisting">  "label"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1805
1805
<p>The text of the label.</p>
1806
1806
<p>Default value: ""</p>
1807
1807
</div>
1808
1808
<hr>
1809
1809
<div class="refsect2" title='The "max-width-chars" property'>
1810
1810
<a name="GtkLabel--max-width-chars"></a><h3>The <code class="literal">"max-width-chars"</code> property</h3>
1811
 
<pre class="programlisting">  "max-width-chars"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1811
<pre class="programlisting">  "max-width-chars"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1812
1812
<p>
1813
1813
The desired maximum width of the label, in characters. If this property 
1814
1814
is set to -1, the width will be calculated automatically, otherwise the 
1823
1823
<hr>
1824
1824
<div class="refsect2" title='The "mnemonic-keyval" property'>
1825
1825
<a name="GtkLabel--mnemonic-keyval"></a><h3>The <code class="literal">"mnemonic-keyval"</code> property</h3>
1826
 
<pre class="programlisting">  "mnemonic-keyval"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
 
1826
<pre class="programlisting">  "mnemonic-keyval"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
1827
1827
<p>The mnemonic accelerator key for this label.</p>
1828
1828
<p>Default value: 16777215</p>
1829
1829
</div>
1836
1836
<hr>
1837
1837
<div class="refsect2" title='The "pattern" property'>
1838
1838
<a name="GtkLabel--pattern"></a><h3>The <code class="literal">"pattern"</code> property</h3>
1839
 
<pre class="programlisting">  "pattern"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write</pre>
 
1839
<pre class="programlisting">  "pattern"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write</pre>
1840
1840
<p>A string with _ characters in positions correspond to characters in the text to underline.</p>
1841
1841
<p>Default value: NULL</p>
1842
1842
</div>
1843
1843
<hr>
1844
1844
<div class="refsect2" title='The "selectable" property'>
1845
1845
<a name="GtkLabel--selectable"></a><h3>The <code class="literal">"selectable"</code> property</h3>
1846
 
<pre class="programlisting">  "selectable"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1846
<pre class="programlisting">  "selectable"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1847
1847
<p>Whether the label text can be selected with the mouse.</p>
1848
1848
<p>Default value: FALSE</p>
1849
1849
</div>
1850
1850
<hr>
1851
1851
<div class="refsect2" title='The "selection-bound" property'>
1852
1852
<a name="GtkLabel--selection-bound"></a><h3>The <code class="literal">"selection-bound"</code> property</h3>
1853
 
<pre class="programlisting">  "selection-bound"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1853
<pre class="programlisting">  "selection-bound"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1854
1854
<p>The position of the opposite end of the selection from the cursor in chars.</p>
1855
1855
<p>Allowed values: &gt;= 0</p>
1856
1856
<p>Default value: 0</p>
1858
1858
<hr>
1859
1859
<div class="refsect2" title='The "single-line-mode" property'>
1860
1860
<a name="GtkLabel--single-line-mode"></a><h3>The <code class="literal">"single-line-mode"</code> property</h3>
1861
 
<pre class="programlisting">  "single-line-mode"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1861
<pre class="programlisting">  "single-line-mode"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1862
1862
<p>
1863
1863
Whether the label is in single line mode. In single line mode,
1864
1864
the height of the label does not depend on the actual text, it
1872
1872
<hr>
1873
1873
<div class="refsect2" title='The "track-visited-links" property'>
1874
1874
<a name="GtkLabel--track-visited-links"></a><h3>The <code class="literal">"track-visited-links"</code> property</h3>
1875
 
<pre class="programlisting">  "track-visited-links"      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1875
<pre class="programlisting">  "track-visited-links"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1876
1876
<p>
1877
 
Set this property to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to make the label track which links
 
1877
Set this property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to make the label track which links
1878
1878
have been clicked. It will then apply the ::visited-link-color
1879
1879
color, instead of ::link-color.
1880
1880
</p>
1884
1884
<hr>
1885
1885
<div class="refsect2" title='The "use-markup" property'>
1886
1886
<a name="GtkLabel--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3>
1887
 
<pre class="programlisting">  "use-markup"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1887
<pre class="programlisting">  "use-markup"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1888
1888
<p>The text of the label includes XML markup. See pango_parse_markup().</p>
1889
1889
<p>Default value: FALSE</p>
1890
1890
</div>
1891
1891
<hr>
1892
1892
<div class="refsect2" title='The "use-underline" property'>
1893
1893
<a name="GtkLabel--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>
1894
 
<pre class="programlisting">  "use-underline"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1894
<pre class="programlisting">  "use-underline"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1895
1895
<p>If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key.</p>
1896
1896
<p>Default value: FALSE</p>
1897
1897
</div>
1898
1898
<hr>
1899
1899
<div class="refsect2" title='The "width-chars" property'>
1900
1900
<a name="GtkLabel--width-chars"></a><h3>The <code class="literal">"width-chars"</code> property</h3>
1901
 
<pre class="programlisting">  "width-chars"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1901
<pre class="programlisting">  "width-chars"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1902
1902
<p>
1903
1903
The desired width of the label, in characters. If this property is set to
1904
1904
-1, the width will be calculated automatically, otherwise the label will
1913
1913
<hr>
1914
1914
<div class="refsect2" title='The "wrap" property'>
1915
1915
<a name="GtkLabel--wrap"></a><h3>The <code class="literal">"wrap"</code> property</h3>
1916
 
<pre class="programlisting">  "wrap"                     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1916
<pre class="programlisting">  "wrap"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1917
1917
<p>If set, wrap lines if the text becomes too wide.</p>
1918
1918
<p>Default value: FALSE</p>
1919
1919
</div>
1935
1935
<div class="refsect2" title='The "activate-current-link" signal'>
1936
1936
<a name="GtkLabel-activate-current-link"></a><h3>The <code class="literal">"activate-current-link"</code> signal</h3>
1937
1937
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
1938
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last / Action</pre>
 
1938
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last / Action</pre>
1939
1939
<p>
1940
1940
A <a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
1941
1941
which gets emitted when the user activates a link in the label.
1942
1942
</p>
1943
1943
<p>
1944
 
Applications may also emit the signal with <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a>
 
1944
Applications may also emit the signal with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a>
1945
1945
if they need to control activation of URIs programmatically.
1946
1946
</p>
1947
1947
<p>
1966
1966
<hr>
1967
1967
<div class="refsect2" title='The "activate-link" signal'>
1968
1968
<a name="GtkLabel-activate-link"></a><h3>The <code class="literal">"activate-link"</code> signal</h3>
1969
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
1970
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>    *uri,
1971
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last</pre>
 
1969
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
 
1970
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>    *uri,
 
1971
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last</pre>
1972
1972
<p>
1973
1973
The signal which gets emitted to activate a URI.
1974
1974
Applications may connect to it to override the default behaviour,
1993
1993
</tr>
1994
1994
<tr>
1995
1995
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1996
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the link has been activated
 
1996
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the link has been activated
1997
1997
</td>
1998
1998
</tr>
1999
1999
</tbody>
2004
2004
<div class="refsect2" title='The "copy-clipboard" signal'>
2005
2005
<a name="GtkLabel-copy-clipboard"></a><h3>The <code class="literal">"copy-clipboard"</code> signal</h3>
2006
2006
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
2007
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last / Action</pre>
 
2007
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last / Action</pre>
2008
2008
<p>
2009
2009
The ::copy-clipboard signal is a
2010
2010
<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
2033
2033
<a name="GtkLabel-move-cursor"></a><h3>The <code class="literal">"move-cursor"</code> signal</h3>
2034
2034
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>       *entry,
2035
2035
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step,
2036
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>            count,
2037
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>        extend_selection,
2038
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)             : Run Last / Action</pre>
 
2036
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>            count,
 
2037
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>        extend_selection,
 
2038
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)             : Run Last / Action</pre>
2039
2039
<p>
2040
2040
The ::move-cursor signal is a
2041
2041
<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
2045
2045
</p>
2046
2046
<p>
2047
2047
Applications should not connect to it, but may emit it with
2048
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control the cursor
 
2048
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control the cursor
2049
2049
programmatically.
2050
2050
</p>
2051
2051
<p>
2082
2082
<tr>
2083
2083
<td><p><span class="term"><em class="parameter"><code>extend_selection</code></em> :</span></p></td>
2084
2084
<td>
2085
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the move should extend the selection
 
2085
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the move should extend the selection
2086
2086
</td>
2087
2087
</tr>
2088
2088
<tr>
2097
2097
<a name="GtkLabel-populate-popup"></a><h3>The <code class="literal">"populate-popup"</code> signal</h3>
2098
2098
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
2099
2099
                                                        <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>  *menu,
2100
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last</pre>
 
2100
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : Run Last</pre>
2101
2101
<p>
2102
2102
The ::populate-popup signal gets emitted before showing the
2103
2103
context menu of the label. Note that only selectable labels