← Back to branch summary

~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Didier Roche, Till Kamppeter, Didier Roche
  • Date: 2012-09-24 13:56:56 UTC
  • mfrom: (1.14.15)
  • Revision ID: package-import@ubuntu.com-20120924135656-rjoa3makg1cvn7y1
Tags: 2.24.13-0ubuntu1
https://launchpad.net/bugs/1053891
https://launchpad.net/bugs/937822
[ Till Kamppeter ]
* debian/patches/print-dialog-show-options-of-remote-dnssd-printers.patch:
  Make printing on remote DNS-SD/Bonjour-shared printers working
  (LP: #1053891).

[ Didier Roche ]
* New upstream release:
  - F10 always opens the menu, cannot be overriden (LP: #937822)

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
struct              <a class="link" href="GtkLabel.html#GtkLabel-struct" title="struct 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 <span class="type">gchar</span> *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 <span class="type">gchar</span> *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
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>);
 
56
                                                         <em class="parameter"><code><span class="type">PangoAttrList</span> *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 <span class="type">gchar</span> *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 <span class="type">gchar</span> *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 <span class="type">gchar</span> *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
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> mode</code></em>);
 
66
                                                         <em class="parameter"><code><span class="type">PangoEllipsizeMode</span> 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><span class="type">gint</span> 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><span class="type">gint</span> 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><span class="type">gchar</span> **str</code></em>);
73
 
<span class="returnvalue">guint</span>               <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 <span class="type">gchar</span> *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><span class="type">gboolean</span> 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
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> wrap_mode</code></em>);
 
78
                                                         <em class="parameter"><code><span class="type">PangoWrapMode</span> 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><span class="type">gint</span> *x</code></em>,
82
 
                                                         <em class="parameter"><code><span class="type">gint</span> *y</code></em>);
83
 
<span class="returnvalue">guint</span>               <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
 
<span class="returnvalue">gboolean</span>            <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 <span class="returnvalue">gchar</span> *       <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 <span class="type">gchar</span> *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><span class="type">gint</span> start_offset</code></em>,
89
 
                                                         <em class="parameter"><code><span class="type">gint</span> 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><span class="type">gboolean</span> 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 <span class="type">gchar</span> *str</code></em>);
96
 
<a href="/home/mclasen/gnome/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>);
 
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
<span class="returnvalue">PangoAttrList</span> *     <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
 
<a href="/home/mclasen/gnome/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
 
<span class="returnvalue">gint</span>                <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
 
<span class="returnvalue">gint</span>                <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 <span class="returnvalue">gchar</span> *       <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
 
<a href="/home/mclasen/gnome/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
 
<span class="returnvalue">gboolean</span>            <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
 
<a href="/home/mclasen/gnome/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>);
 
98
<span class="returnvalue">PangoEllipsizeMode</span>  <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="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
<span class="returnvalue">PangoLayout</span> *       <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="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
<span class="returnvalue">PangoWrapMode</span>       <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
 
<span class="returnvalue">gboolean</span>            <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><span class="type">gint</span> *start</code></em>,
108
 
                                                         <em class="parameter"><code><span class="type">gint</span> *end</code></em>);
109
 
<span class="returnvalue">gboolean</span>            <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
 
<span class="returnvalue">gboolean</span>            <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
 
<span class="returnvalue">gboolean</span>            <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
 
<span class="returnvalue">gdouble</span>             <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 <span class="type">gchar</span> *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><span class="type">gboolean</span> 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><span class="type">gboolean</span> 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><span class="type">gboolean</span> 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><span class="type">gdouble</span> angle</code></em>);
123
 
const <span class="returnvalue">gchar</span> *       <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><span class="type">gboolean</span> track_links</code></em>);
126
 
<span class="returnvalue">gboolean</span>            <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">
148
148
<div class="refsect1">
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>"                    <span class="type">gdouble</span>               : Read / Write
152
 
  "<a class="link" href="GtkLabel.html#GtkLabel--attributes" title='The "attributes" property'>attributes</a>"               <a href="/home/mclasen/gnome/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>"          <span class="type">gint</span>                  : Read
154
 
  "<a class="link" href="GtkLabel.html#GtkLabel--ellipsize" title='The "ellipsize" property'>ellipsize</a>"                <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</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
  "<a class="link" href="GtkLabel.html#GtkLabel--attributes" title='The "attributes" property'>attributes</a>"               <span class="type">PangoAttrList</span>*        : Read / Write
 
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
  "<a class="link" href="GtkLabel.html#GtkLabel--ellipsize" title='The "ellipsize" property'>ellipsize</a>"                <span class="type">PangoEllipsizeMode</span>    : 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>"                    <span class="type">gchar</span>*                : Read / Write
157
 
  "<a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'>max-width-chars</a>"          <span class="type">gint</span>                  : Read / Write
158
 
  "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-keyval" title='The "mnemonic-keyval" property'>mnemonic-keyval</a>"          <span class="type">guint</span>                 : 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>"                  <span class="type">gchar</span>*                : Write
161
 
  "<a class="link" href="GtkLabel.html#GtkLabel--selectable" title='The "selectable" property'>selectable</a>"               <span class="type">gboolean</span>              : Read / Write
162
 
  "<a class="link" href="GtkLabel.html#GtkLabel--selection-bound" title='The "selection-bound" property'>selection-bound</a>"          <span class="type">gint</span>                  : Read
163
 
  "<a class="link" href="GtkLabel.html#GtkLabel--single-line-mode" title='The "single-line-mode" property'>single-line-mode</a>"         <span class="type">gboolean</span>              : Read / Write
164
 
  "<a class="link" href="GtkLabel.html#GtkLabel--track-visited-links" title='The "track-visited-links" property'>track-visited-links</a>"      <span class="type">gboolean</span>              : Read / Write
165
 
  "<a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'>use-markup</a>"               <span class="type">gboolean</span>              : Read / Write
166
 
  "<a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'>use-underline</a>"            <span class="type">gboolean</span>              : Read / Write
167
 
  "<a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'>width-chars</a>"              <span class="type">gint</span>                  : Read / Write
168
 
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'>wrap</a>"                     <span class="type">gboolean</span>              : Read / Write
169
 
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap-mode" title='The "wrap-mode" property'>wrap-mode</a>"                <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</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
  "<a class="link" href="GtkLabel.html#GtkLabel--wrap-mode" title='The "wrap-mode" property'>wrap-mode</a>"                <span class="type">PangoWrapMode</span>         : Read / Write
170
170
</pre>
171
171
</div>
172
172
<div class="refsect1">
192
192
The GtkLabel implementation of the GtkBuildable interface supports a
193
193
custom &lt;attributes&gt; element, which supports any number of &lt;attribute&gt;
194
194
elements. the &lt;attribute&gt; element has attributes named name, value,
195
 
start and end and allows you to specify <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> values for this label.
 
195
start and end and allows you to specify <span class="type">PangoAttribute</span> values for this label.
196
196
</p>
197
197
<div class="example">
198
 
<a name="id743003"></a><p class="title"><b>Example 13. A UI definition fragment specifying Pango attributes</b></p>
 
198
<a name="idp31879136"></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>
228
228
</div>
229
229
<hr>
230
230
<div class="refsect2">
231
 
<a name="id743026"></a><h3>Mnemonics</h3>
 
231
<a name="idp31881888"></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">
308
 
<a name="id743147"></a><h3>Markup (styled text)</h3>
 
308
<a name="idp31896480"></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
 
etc.), label text can be provided in a simple <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">markup format</a>.
 
311
etc.), label text can be provided in a simple markup format.
312
312
Here's how to create a label with a small font:
313
313
</p>
314
314
<div class="informalexample">
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="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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>
325
325
</div>
326
326
 
327
327
<p>
328
 
(See <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">complete documentation</a> of available
 
328
(See complete documentation of available
329
329
tags in the Pango manual.)
330
330
</p>
331
331
<p>
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
 
<code class="function">g_markup_escape_text()</code> or <code class="function">g_markup_printf_escaped()</code>.
 
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
 
Markup strings are just a convenient way to set the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> on
 
339
Markup strings are just a convenient way to set the <span class="type">PangoAttrList</span> on
340
340
a label; <a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()"><code class="function">gtk_label_set_attributes()</code></a> may be a simpler way to set
341
 
attributes in some cases. Be careful though; <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> tends to
 
341
attributes in some cases. Be careful though; <span class="type">PangoAttrList</span> tends to
342
342
cause internationalization problems, unless you're applying attributes
343
343
to the entire string (i.e. unless you set the range of each attribute
344
344
to [0, G_MAXINT)). The reason is that specifying the start_index and
345
 
end_index for a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> requires knowledge of the exact string
 
345
end_index for a <span class="type">PangoAttribute</span> requires knowledge of the exact string
346
346
being displayed, so translations will cause problems.
347
347
</p>
348
348
</div>
349
349
<hr>
350
350
<div class="refsect2">
351
 
<a name="id743264"></a><h3>Selectable labels</h3>
 
351
<a name="idp31910528"></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">
361
 
<a name="id743287"></a><h3>Text layout</h3>
 
361
<a name="idp31913296"></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">
380
 
<a name="id743338"></a><h3>Links</h3>
 
380
<a name="idp31919440"></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">
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 <span class="type">gchar</span> *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="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.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" class="variablelist">
424
424
<colgroup>
442
442
<div class="refsect2">
443
443
<a name="gtk-label-set-text"></a><h3>gtk_label_set_text ()</h3>
444
444
<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>,
445
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
 
445
                                                         <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>
446
446
<p>
447
447
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
448
448
was there before.  
472
472
<div class="refsect2">
473
473
<a name="gtk-label-set-attributes"></a><h3>gtk_label_set_attributes ()</h3>
474
474
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_attributes            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
475
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>);</pre>
 
475
                                                         <em class="parameter"><code><span class="type">PangoAttrList</span> *attrs</code></em>);</pre>
476
476
<p>
477
 
Sets a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>; the attributes in the list are applied to the
 
477
Sets a <span class="type">PangoAttrList</span>; the attributes in the list are applied to the
478
478
label text. 
479
479
</p>
480
480
<p>
503
503
</tr>
504
504
<tr>
505
505
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
506
 
<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>
 
506
<td>a <span class="type">PangoAttrList</span>
507
507
</td>
508
508
</tr>
509
509
</tbody>
513
513
<div class="refsect2">
514
514
<a name="gtk-label-set-markup"></a><h3>gtk_label_set_markup ()</h3>
515
515
<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>,
516
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
 
516
                                                         <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>
517
517
<p>
518
 
Parses <em class="parameter"><code>str</code></em> which is marked up with the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>, setting the
 
518
Parses <em class="parameter"><code>str</code></em> which is marked up with the Pango text markup language, setting the
519
519
label's text and attribute list based on the parse results. If the <em class="parameter"><code>str</code></em> is
520
 
external data, you may need to escape it with <code class="function">g_markup_escape_text()</code> or
521
 
<code class="function">g_markup_printf_escaped()</code>:
 
520
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
 
521
<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>:
522
522
</p>
523
523
<div class="informalexample">
524
524
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
531
531
5</pre></td>
532
532
        <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>
533
533
<span class="normal">  </span>
534
 
<span class="normal">markup </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_markup_printf_escaped</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>
 
534
<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>
535
535
<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>
536
 
<span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">markup</span><span class="symbol">);</span></pre></td>
 
536
<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>
537
537
      </tr>
538
538
    </tbody>
539
539
  </table>
554
554
</tr>
555
555
<tr>
556
556
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
557
 
<td>a markup string (see <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td>
 
557
<td>a markup string (see Pango markup format)</td>
558
558
</tr>
559
559
</tbody>
560
560
</table></div>
563
563
<div class="refsect2">
564
564
<a name="gtk-label-set-markup-with-mnemonic"></a><h3>gtk_label_set_markup_with_mnemonic ()</h3>
565
565
<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>,
566
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
 
566
                                                         <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>
567
567
<p>
568
 
Parses <em class="parameter"><code>str</code></em> which is marked up with the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>,
 
568
Parses <em class="parameter"><code>str</code></em> which is marked up with the Pango text markup language,
569
569
setting the label's text and attribute list based on the parse results.
570
570
If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are underlined
571
571
indicating that they represent a keyboard accelerator called a mnemonic.
587
587
</tr>
588
588
<tr>
589
589
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
590
 
<td>a markup string (see <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td>
 
590
<td>a markup string (see Pango markup format)</td>
591
591
</tr>
592
592
</tbody>
593
593
</table></div>
596
596
<div class="refsect2">
597
597
<a name="gtk-label-set-pattern"></a><h3>gtk_label_set_pattern ()</h3>
598
598
<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>,
599
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *pattern</code></em>);</pre>
 
599
                                                         <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>
600
600
<p>
601
601
The pattern of underlines you want under the existing text within the
602
602
<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
656
656
<div class="refsect2">
657
657
<a name="gtk-label-set-ellipsize"></a><h3>gtk_label_set_ellipsize ()</h3>
658
658
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_ellipsize             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
659
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> mode</code></em>);</pre>
 
659
                                                         <em class="parameter"><code><span class="type">PangoEllipsizeMode</span> mode</code></em>);</pre>
660
660
<p>
661
661
Sets the mode used to ellipsize (add an ellipsis: "...") to the text 
662
662
if there is not enough space to render the entire string.
674
674
</tr>
675
675
<tr>
676
676
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
677
 
<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a>
 
677
<td>a <span class="type">PangoEllipsizeMode</span>
678
678
</td>
679
679
</tr>
680
680
</tbody>
685
685
<div class="refsect2">
686
686
<a name="gtk-label-set-width-chars"></a><h3>gtk_label_set_width_chars ()</h3>
687
687
<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>,
688
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_chars</code></em>);</pre>
 
688
                                                         <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>
689
689
<p>
690
690
Sets the desired width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>.
691
691
</p>
712
712
<div class="refsect2">
713
713
<a name="gtk-label-set-max-width-chars"></a><h3>gtk_label_set_max_width_chars ()</h3>
714
714
<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>,
715
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_chars</code></em>);</pre>
 
715
                                                         <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>
716
716
<p>
717
717
Sets the desired maximum width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>.
718
718
</p>
739
739
<div class="refsect2">
740
740
<a name="gtk-label-get"></a><h3>gtk_label_get ()</h3>
741
741
<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>,
742
 
                                                         <em class="parameter"><code><span class="type">gchar</span> **str</code></em>);</pre>
 
742
                                                         <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>
743
743
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
744
744
<h3 class="title">Warning</h3>
745
745
<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>
769
769
<hr>
770
770
<div class="refsect2">
771
771
<a name="gtk-label-parse-uline"></a><h3>gtk_label_parse_uline ()</h3>
772
 
<pre class="programlisting"><span class="returnvalue">guint</span>               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>,
773
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *string</code></em>);</pre>
 
772
<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>,
 
773
                                                         <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>
774
774
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
775
775
<h3 class="title">Warning</h3>
776
776
<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>
807
807
<div class="refsect2">
808
808
<a name="gtk-label-set-line-wrap"></a><h3>gtk_label_set_line_wrap ()</h3>
809
809
<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>,
810
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> wrap</code></em>);</pre>
 
810
                                                         <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>
811
811
<p>
812
 
Toggles line wrapping within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. <code class="literal">TRUE</code> makes it break
813
 
lines if text exceeds the widget's size. <code class="literal">FALSE</code> lets the text get cut off
 
812
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
 
813
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
814
814
by the edge of the widget if it exceeds the widget size.
815
815
</p>
816
816
<p>
817
 
Note that setting line wrapping to <code class="literal">TRUE</code> does not make the label
 
817
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
818
818
wrap at its parent container's width, because GTK+ widgets
819
819
conceptually can't make their requisition depend on the parent
820
820
container's size. For a label that wraps at a specific position,
842
842
<div class="refsect2">
843
843
<a name="gtk-label-set-line-wrap-mode"></a><h3>gtk_label_set_line_wrap_mode ()</h3>
844
844
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_label_set_line_wrap_mode        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>,
845
 
                                                         <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> wrap_mode</code></em>);</pre>
 
845
                                                         <em class="parameter"><code><span class="type">PangoWrapMode</span> wrap_mode</code></em>);</pre>
846
846
<p>
847
847
If line wrapping is on (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>) this controls how
848
 
the line wrapping is done. The default is <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-WRAP-WORD:CAPS"><code class="literal">PANGO_WRAP_WORD</code></a> which means
 
848
the line wrapping is done. The default is <code class="literal">PANGO_WRAP_WORD</code> which means
849
849
wrap on word boundaries.
850
850
</p>
851
851
<div class="variablelist"><table border="0" class="variablelist">
884
884
<div class="refsect2">
885
885
<a name="gtk-label-get-layout-offsets"></a><h3>gtk_label_get_layout_offsets ()</h3>
886
886
<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>,
887
 
                                                         <em class="parameter"><code><span class="type">gint</span> *x</code></em>,
888
 
                                                         <em class="parameter"><code><span class="type">gint</span> *y</code></em>);</pre>
 
887
                                                         <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>,
 
888
                                                         <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>
889
889
<p>
890
 
Obtains the coordinates where the label will draw the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
 
890
Obtains the coordinates where the label will draw the <span class="type">PangoLayout</span>
891
891
representing the text in the label; useful to convert mouse events
892
 
into coordinates inside the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, e.g. to take some action
 
892
into coordinates inside the <span class="type">PangoLayout</span>, e.g. to take some action
893
893
if some part of the label is clicked. Of course you will need to
894
894
create a <a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a> to receive the events, and pack the label
895
895
inside it, since labels are a <a class="link" href="GtkWidget.html#GTK-NO-WINDOW:CAPS"><span class="type">GTK_NO_WINDOW</span></a> widget. Remember
896
 
when using the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> functions you need to convert to
897
 
and from pixels using <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"><code class="function">PANGO_PIXELS()</code></a> or <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><span class="type">PANGO_SCALE</span></a>.
 
896
when using the <span class="type">PangoLayout</span> functions you need to convert to
 
897
and from pixels using <code class="function">PANGO_PIXELS()</code> or <span class="type">PANGO_SCALE</span>.
898
898
</p>
899
899
<div class="variablelist"><table border="0" class="variablelist">
900
900
<colgroup>
909
909
</tr>
910
910
<tr>
911
911
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
912
 
<td>location to store X offset of layout, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
912
<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="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
913
913
</td>
914
914
</tr>
915
915
<tr>
916
916
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
917
 
<td>location to store Y offset of layout, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
917
<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="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
918
918
</td>
919
919
</tr>
920
920
</tbody>
923
923
<hr>
924
924
<div class="refsect2">
925
925
<a name="gtk-label-get-mnemonic-keyval"></a><h3>gtk_label_get_mnemonic_keyval ()</h3>
926
 
<pre class="programlisting"><span class="returnvalue">guint</span>               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>
 
926
<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>
927
927
<p>
928
928
If the label has been set so that it has an mnemonic key this function
929
929
returns the keyval used for the mnemonic accelerator. If there is no
951
951
<hr>
952
952
<div class="refsect2">
953
953
<a name="gtk-label-get-selectable"></a><h3>gtk_label_get_selectable ()</h3>
954
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
954
<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>
955
955
<p>
956
956
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>.
957
957
</p>
969
969
<tr>
970
970
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
971
971
<td>
972
 
<code class="literal">TRUE</code> if the user can copy text from the label</td>
 
972
<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</td>
973
973
</tr>
974
974
</tbody>
975
975
</table></div>
977
977
<hr>
978
978
<div class="refsect2">
979
979
<a name="gtk-label-get-text"></a><h3>gtk_label_get_text ()</h3>
980
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       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>
 
980
<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>
981
981
<p>
982
982
Fetches the text from a label widget, as displayed on the
983
983
screen. This does not include any embedded underlines
1005
1005
<hr>
1006
1006
<div class="refsect2">
1007
1007
<a name="gtk-label-new-with-mnemonic"></a><h3>gtk_label_new_with_mnemonic ()</h3>
1008
 
<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 <span class="type">gchar</span> *str</code></em>);</pre>
 
1008
<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>
1009
1009
<p>
1010
1010
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>.
1011
1011
</p>
1047
1047
<div class="refsect2">
1048
1048
<a name="gtk-label-select-region"></a><h3>gtk_label_select_region ()</h3>
1049
1049
<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>,
1050
 
                                                         <em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
1051
 
                                                         <em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
 
1050
                                                         <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>,
 
1051
                                                         <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>
1052
1052
<p>
1053
1053
Selects a range of characters in the label, if the label is selectable.
1054
1054
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,
1122
1122
<div class="refsect2">
1123
1123
<a name="gtk-label-set-selectable"></a><h3>gtk_label_set_selectable ()</h3>
1124
1124
<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>,
1125
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
 
1125
                                                         <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>
1126
1126
<p>
1127
1127
Selectable labels allow the user to select text from the label, for
1128
1128
copy-and-paste.
1141
1141
<tr>
1142
1142
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1143
1143
<td>
1144
 
<code class="literal">TRUE</code> to allow selecting text in the label</td>
 
1144
<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</td>
1145
1145
</tr>
1146
1146
</tbody>
1147
1147
</table></div>
1150
1150
<div class="refsect2">
1151
1151
<a name="gtk-label-set-text-with-mnemonic"></a><h3>gtk_label_set_text_with_mnemonic ()</h3>
1152
1152
<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>,
1153
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
 
1153
                                                         <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>
1154
1154
<p>
1155
1155
Sets the label's text from the string <em class="parameter"><code>str</code></em>.
1156
1156
If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are underlined
1179
1179
<hr>
1180
1180
<div class="refsect2">
1181
1181
<a name="gtk-label-get-attributes"></a><h3>gtk_label_get_attributes ()</h3>
1182
 
<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> *     gtk_label_get_attributes            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1182
<pre class="programlisting"><span class="returnvalue">PangoAttrList</span> *     gtk_label_get_attributes            (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1183
1183
<p>
1184
1184
Gets the attribute list that was set on the label using
1185
1185
<a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()"><code class="function">gtk_label_set_attributes()</code></a>, if any. This function does
1201
1201
</tr>
1202
1202
<tr>
1203
1203
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1204
 
<td>the attribute list, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
 
1204
<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>
1205
1205
if none was set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1206
1206
</td>
1207
1207
</tr>
1236
1236
<hr>
1237
1237
<div class="refsect2">
1238
1238
<a name="gtk-label-get-ellipsize"></a><h3>gtk_label_get_ellipsize ()</h3>
1239
 
<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="returnvalue">PangoEllipsizeMode</span></a>  gtk_label_get_ellipsize             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1239
<pre class="programlisting"><span class="returnvalue">PangoEllipsizeMode</span>  gtk_label_get_ellipsize             (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1240
1240
<p>
1241
1241
Returns the ellipsizing position of the label. See <a class="link" href="GtkLabel.html#gtk-label-set-ellipsize" title="gtk_label_set_ellipsize ()"><code class="function">gtk_label_set_ellipsize()</code></a>.
1242
1242
</p>
1253
1253
</tr>
1254
1254
<tr>
1255
1255
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1256
 
<td><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a></td>
 
1256
<td><span class="type">PangoEllipsizeMode</span></td>
1257
1257
</tr>
1258
1258
</tbody>
1259
1259
</table></div>
1262
1262
<hr>
1263
1263
<div class="refsect2">
1264
1264
<a name="gtk-label-get-width-chars"></a><h3>gtk_label_get_width_chars ()</h3>
1265
 
<pre class="programlisting"><span class="returnvalue">gint</span>                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>
 
1265
<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>
1266
1266
<p>
1267
1267
Retrieves the desired width of <em class="parameter"><code>label</code></em>, in characters. See
1268
1268
<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>.
1289
1289
<hr>
1290
1290
<div class="refsect2">
1291
1291
<a name="gtk-label-get-max-width-chars"></a><h3>gtk_label_get_max_width_chars ()</h3>
1292
 
<pre class="programlisting"><span class="returnvalue">gint</span>                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>
 
1292
<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>
1293
1293
<p>
1294
1294
Retrieves the desired maximum width of <em class="parameter"><code>label</code></em>, in characters. See
1295
1295
<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>.
1316
1316
<hr>
1317
1317
<div class="refsect2">
1318
1318
<a name="gtk-label-get-label"></a><h3>gtk_label_get_label ()</h3>
1319
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       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>
 
1319
<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>
1320
1320
<p>
1321
1321
Fetches the text from a label widget including any embedded
1322
1322
underlines indicating mnemonics and Pango markup. (See
1344
1344
<hr>
1345
1345
<div class="refsect2">
1346
1346
<a name="gtk-label-get-layout"></a><h3>gtk_label_get_layout ()</h3>
1347
 
<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> *       gtk_label_get_layout                (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1347
<pre class="programlisting"><span class="returnvalue">PangoLayout</span> *       gtk_label_get_layout                (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1348
1348
<p>
1349
 
Gets the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> used to display the label.
 
1349
Gets the <span class="type">PangoLayout</span> used to display the label.
1350
1350
The layout is useful to e.g. convert text positions to
1351
1351
pixel positions, in combination with <a class="link" href="GtkLabel.html#gtk-label-get-layout-offsets" title="gtk_label_get_layout_offsets ()"><code class="function">gtk_label_get_layout_offsets()</code></a>.
1352
1352
The returned layout is owned by the label so need not be
1365
1365
</tr>
1366
1366
<tr>
1367
1367
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1368
 
<td>the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> for this label. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
1368
<td>the <span class="type">PangoLayout</span> for this label. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1369
1369
</td>
1370
1370
</tr>
1371
1371
</tbody>
1374
1374
<hr>
1375
1375
<div class="refsect2">
1376
1376
<a name="gtk-label-get-line-wrap"></a><h3>gtk_label_get_line_wrap ()</h3>
1377
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
1377
<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>
1378
1378
<p>
1379
1379
Returns whether lines in the label are automatically wrapped. 
1380
1380
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>.
1393
1393
<tr>
1394
1394
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1395
1395
<td>
1396
 
<code class="literal">TRUE</code> if the lines of the label are automatically wrapped.</td>
 
1396
<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.</td>
1397
1397
</tr>
1398
1398
</tbody>
1399
1399
</table></div>
1401
1401
<hr>
1402
1402
<div class="refsect2">
1403
1403
<a name="gtk-label-get-line-wrap-mode"></a><h3>gtk_label_get_line_wrap_mode ()</h3>
1404
 
<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="returnvalue">PangoWrapMode</span></a>       gtk_label_get_line_wrap_mode        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
 
1404
<pre class="programlisting"><span class="returnvalue">PangoWrapMode</span>       gtk_label_get_line_wrap_mode        (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre>
1405
1405
<p>
1406
1406
Returns line wrap mode used by the label. See <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap-mode" title="gtk_label_set_line_wrap_mode ()"><code class="function">gtk_label_set_line_wrap_mode()</code></a>.
1407
1407
</p>
1419
1419
<tr>
1420
1420
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1421
1421
<td>
1422
 
<code class="literal">TRUE</code> if the lines of the label are automatically wrapped.</td>
 
1422
<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.</td>
1423
1423
</tr>
1424
1424
</tbody>
1425
1425
</table></div>
1447
1447
<tr>
1448
1448
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1449
1449
<td>the target of the label's mnemonic,
1450
 
or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none has been set and the default algorithm will be used. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
1450
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none has been set and the default algorithm will be used. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1451
1451
</td>
1452
1452
</tr>
1453
1453
</tbody>
1456
1456
<hr>
1457
1457
<div class="refsect2">
1458
1458
<a name="gtk-label-get-selection-bounds"></a><h3>gtk_label_get_selection_bounds ()</h3>
1459
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>,
1460
 
                                                         <em class="parameter"><code><span class="type">gint</span> *start</code></em>,
1461
 
                                                         <em class="parameter"><code><span class="type">gint</span> *end</code></em>);</pre>
 
1459
<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>,
 
1460
                                                         <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>,
 
1461
                                                         <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>
1462
1462
<p>
1463
 
Gets the selected range of characters in the label, returning <code class="literal">TRUE</code>
 
1463
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>
1464
1464
if there's a selection.
1465
1465
</p>
1466
1466
<div class="variablelist"><table border="0" class="variablelist">
1487
1487
<tr>
1488
1488
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1489
1489
<td>
1490
 
<code class="literal">TRUE</code> if selection is non-empty</td>
 
1490
<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</td>
1491
1491
</tr>
1492
1492
</tbody>
1493
1493
</table></div>
1495
1495
<hr>
1496
1496
<div class="refsect2">
1497
1497
<a name="gtk-label-get-use-markup"></a><h3>gtk_label_get_use_markup ()</h3>
1498
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
1498
<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>
1499
1499
<p>
1500
1500
Returns whether the label's text is interpreted as marked up with
1501
1501
the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup
1515
1515
<tr>
1516
1516
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1517
1517
<td>
1518
 
<code class="literal">TRUE</code> if the label's text will be parsed for markup.</td>
 
1518
<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.</td>
1519
1519
</tr>
1520
1520
</tbody>
1521
1521
</table></div>
1523
1523
<hr>
1524
1524
<div class="refsect2">
1525
1525
<a name="gtk-label-get-use-underline"></a><h3>gtk_label_get_use_underline ()</h3>
1526
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
1526
<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>
1527
1527
<p>
1528
1528
Returns whether an embedded underline in the label indicates a
1529
1529
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>.
1542
1542
<tr>
1543
1543
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1544
1544
<td>
1545
 
<code class="literal">TRUE</code> whether an embedded underline in the label indicates
 
1545
<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
1546
1546
the mnemonic accelerator keys.</td>
1547
1547
</tr>
1548
1548
</tbody>
1551
1551
<hr>
1552
1552
<div class="refsect2">
1553
1553
<a name="gtk-label-get-single-line-mode"></a><h3>gtk_label_get_single_line_mode ()</h3>
1554
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
1554
<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>
1555
1555
<p>
1556
1556
Returns whether the label is in single line mode.
1557
1557
</p>
1569
1569
<tr>
1570
1570
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1571
1571
<td>
1572
 
<code class="literal">TRUE</code> when the label is in single line mode.</td>
 
1572
<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.</td>
1573
1573
</tr>
1574
1574
</tbody>
1575
1575
</table></div>
1578
1578
<hr>
1579
1579
<div class="refsect2">
1580
1580
<a name="gtk-label-get-angle"></a><h3>gtk_label_get_angle ()</h3>
1581
 
<pre class="programlisting"><span class="returnvalue">gdouble</span>             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>
 
1581
<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>
1582
1582
<p>
1583
1583
Gets the angle of rotation for the label. See
1584
1584
<a class="link" href="GtkLabel.html#gtk-label-set-angle" title="gtk_label_set_angle ()"><code class="function">gtk_label_set_angle()</code></a>.
1606
1606
<div class="refsect2">
1607
1607
<a name="gtk-label-set-label"></a><h3>gtk_label_set_label ()</h3>
1608
1608
<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>,
1609
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
 
1609
                                                         <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>
1610
1610
<p>
1611
1611
Sets the text of the label. The label is interpreted as
1612
1612
including embedded underlines and/or Pango markup depending
1635
1635
<div class="refsect2">
1636
1636
<a name="gtk-label-set-use-markup"></a><h3>gtk_label_set_use_markup ()</h3>
1637
1637
<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>,
1638
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
 
1638
                                                         <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>
1639
1639
<p>
1640
1640
Sets whether the text of the label contains markup in <GTKDOCLINK HREF="PangoMarkupFormat">Pango's text markup
1641
1641
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>.
1654
1654
<tr>
1655
1655
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1656
1656
<td>
1657
 
<code class="literal">TRUE</code> if the label's text should be parsed for markup.</td>
 
1657
<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.</td>
1658
1658
</tr>
1659
1659
</tbody>
1660
1660
</table></div>
1663
1663
<div class="refsect2">
1664
1664
<a name="gtk-label-set-use-underline"></a><h3>gtk_label_set_use_underline ()</h3>
1665
1665
<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>,
1666
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
 
1666
                                                         <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>
1667
1667
<p>
1668
1668
If true, an underline in the text indicates the next character should be
1669
1669
used for the mnemonic accelerator key.
1682
1682
<tr>
1683
1683
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
1684
1684
<td>
1685
 
<code class="literal">TRUE</code> if underlines in the text indicate mnemonics</td>
 
1685
<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</td>
1686
1686
</tr>
1687
1687
</tbody>
1688
1688
</table></div>
1691
1691
<div class="refsect2">
1692
1692
<a name="gtk-label-set-single-line-mode"></a><h3>gtk_label_set_single_line_mode ()</h3>
1693
1693
<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>,
1694
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> single_line_mode</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> single_line_mode</code></em>);</pre>
1695
1695
<p>
1696
1696
Sets whether the label is in single line mode.
1697
1697
</p>
1709
1709
<tr>
1710
1710
<td><p><span class="term"><em class="parameter"><code>single_line_mode</code></em> :</span></p></td>
1711
1711
<td>
1712
 
<code class="literal">TRUE</code> if the label should be in single line mode</td>
 
1712
<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</td>
1713
1713
</tr>
1714
1714
</tbody>
1715
1715
</table></div>
1719
1719
<div class="refsect2">
1720
1720
<a name="gtk-label-set-angle"></a><h3>gtk_label_set_angle ()</h3>
1721
1721
<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>,
1722
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> angle</code></em>);</pre>
 
1722
                                                         <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>
1723
1723
<p>
1724
1724
Sets the angle of rotation for the label. An angle of 90 reads from
1725
1725
from bottom to top, an angle of 270, from top to bottom. The angle
1749
1749
<hr>
1750
1750
<div class="refsect2">
1751
1751
<a name="gtk-label-get-current-uri"></a><h3>gtk_label_get_current_uri ()</h3>
1752
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       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>
 
1752
<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>
1753
1753
<p>
1754
1754
Returns the URI for the currently active link in the label.
1755
1755
The active link is the one under the mouse pointer or, in a
1784
1784
<div class="refsect2">
1785
1785
<a name="gtk-label-set-track-visited-links"></a><h3>gtk_label_set_track_visited_links ()</h3>
1786
1786
<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>,
1787
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> track_links</code></em>);</pre>
 
1787
                                                         <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>
1788
1788
<p>
1789
1789
Sets whether the label should keep track of clicked
1790
1790
links (and use a different color for them).
1803
1803
<tr>
1804
1804
<td><p><span class="term"><em class="parameter"><code>track_links</code></em> :</span></p></td>
1805
1805
<td>
1806
 
<code class="literal">TRUE</code> to track visited links</td>
 
1806
<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</td>
1807
1807
</tr>
1808
1808
</tbody>
1809
1809
</table></div>
1812
1812
<hr>
1813
1813
<div class="refsect2">
1814
1814
<a name="gtk-label-get-track-visited-links"></a><h3>gtk_label_get_track_visited_links ()</h3>
1815
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            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>
 
1815
<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>
1816
1816
<p>
1817
1817
Returns whether the label is currently keeping track
1818
1818
of clicked links.
1831
1831
<tr>
1832
1832
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1833
1833
<td>
1834
 
<code class="literal">TRUE</code> if clicked links are remembered</td>
 
1834
<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</td>
1835
1835
</tr>
1836
1836
</tbody>
1837
1837
</table></div>
1842
1842
<a name="GtkLabel.property-details"></a><h2>Property Details</h2>
1843
1843
<div class="refsect2">
1844
1844
<a name="GtkLabel--angle"></a><h3>The <code class="literal">"angle"</code> property</h3>
1845
 
<pre class="programlisting">  "angle"                    <span class="type">gdouble</span>               : Read / Write</pre>
 
1845
<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>
1846
1846
<p>
1847
1847
The angle that the baseline of the label makes with the horizontal,
1848
1848
in degrees, measured counterclockwise. An angle of 90 reads from
1856
1856
<hr>
1857
1857
<div class="refsect2">
1858
1858
<a name="GtkLabel--attributes"></a><h3>The <code class="literal">"attributes"</code> property</h3>
1859
 
<pre class="programlisting">  "attributes"               <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>*        : Read / Write</pre>
 
1859
<pre class="programlisting">  "attributes"               <span class="type">PangoAttrList</span>*        : Read / Write</pre>
1860
1860
<p>A list of style attributes to apply to the text of the label.</p>
1861
1861
</div>
1862
1862
<hr>
1863
1863
<div class="refsect2">
1864
1864
<a name="GtkLabel--cursor-position"></a><h3>The <code class="literal">"cursor-position"</code> property</h3>
1865
 
<pre class="programlisting">  "cursor-position"          <span class="type">gint</span>                  : Read</pre>
 
1865
<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>
1866
1866
<p>The current position of the insertion cursor in chars.</p>
1867
1867
<p>Allowed values: &gt;= 0</p>
1868
1868
<p>Default value: 0</p>
1870
1870
<hr>
1871
1871
<div class="refsect2">
1872
1872
<a name="GtkLabel--ellipsize"></a><h3>The <code class="literal">"ellipsize"</code> property</h3>
1873
 
<pre class="programlisting">  "ellipsize"                <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a>    : Read / Write</pre>
 
1873
<pre class="programlisting">  "ellipsize"                <span class="type">PangoEllipsizeMode</span>    : Read / Write</pre>
1874
1874
<p>
1875
1875
The preferred place to ellipsize the string, if the label does
1876
1876
not have enough room to display the entire string, specified as a 
1878
1878
</p>
1879
1879
<p>
1880
1880
Note that setting this property to a value other than 
1881
 
<a href="/home/mclasen/gnome/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 
 
1881
<code class="literal">PANGO_ELLIPSIZE_NONE</code> has the side-effect that the label requests 
1882
1882
only enough space to display the ellipsis "...". In particular, this 
1883
1883
means that ellipsizing labels do not work well in notebook tabs, unless 
1884
 
the tab's <span class="type">"tab-expand"</span> property is set to <code class="literal">TRUE</code>. Other ways
 
1884
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
1885
1885
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
1886
1886
<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>.
1887
1887
</p>
1898
1898
<hr>
1899
1899
<div class="refsect2">
1900
1900
<a name="GtkLabel--label"></a><h3>The <code class="literal">"label"</code> property</h3>
1901
 
<pre class="programlisting">  "label"                    <span class="type">gchar</span>*                : Read / Write</pre>
 
1901
<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>
1902
1902
<p>The text of the label.</p>
1903
1903
<p>Default value: ""</p>
1904
1904
</div>
1905
1905
<hr>
1906
1906
<div class="refsect2">
1907
1907
<a name="GtkLabel--max-width-chars"></a><h3>The <code class="literal">"max-width-chars"</code> property</h3>
1908
 
<pre class="programlisting">  "max-width-chars"          <span class="type">gint</span>                  : Read / Write</pre>
 
1908
<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>
1909
1909
<p>
1910
1910
The desired maximum width of the label, in characters. If this property 
1911
1911
is set to -1, the width will be calculated automatically, otherwise the 
1920
1920
<hr>
1921
1921
<div class="refsect2">
1922
1922
<a name="GtkLabel--mnemonic-keyval"></a><h3>The <code class="literal">"mnemonic-keyval"</code> property</h3>
1923
 
<pre class="programlisting">  "mnemonic-keyval"          <span class="type">guint</span>                 : Read</pre>
 
1923
<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>
1924
1924
<p>The mnemonic accelerator key for this label.</p>
1925
1925
<p>Default value: 16777215</p>
1926
1926
</div>
1933
1933
<hr>
1934
1934
<div class="refsect2">
1935
1935
<a name="GtkLabel--pattern"></a><h3>The <code class="literal">"pattern"</code> property</h3>
1936
 
<pre class="programlisting">  "pattern"                  <span class="type">gchar</span>*                : Write</pre>
 
1936
<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>
1937
1937
<p>A string with _ characters in positions correspond to characters in the text to underline.</p>
1938
1938
<p>Default value: NULL</p>
1939
1939
</div>
1940
1940
<hr>
1941
1941
<div class="refsect2">
1942
1942
<a name="GtkLabel--selectable"></a><h3>The <code class="literal">"selectable"</code> property</h3>
1943
 
<pre class="programlisting">  "selectable"               <span class="type">gboolean</span>              : Read / Write</pre>
 
1943
<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>
1944
1944
<p>Whether the label text can be selected with the mouse.</p>
1945
1945
<p>Default value: FALSE</p>
1946
1946
</div>
1947
1947
<hr>
1948
1948
<div class="refsect2">
1949
1949
<a name="GtkLabel--selection-bound"></a><h3>The <code class="literal">"selection-bound"</code> property</h3>
1950
 
<pre class="programlisting">  "selection-bound"          <span class="type">gint</span>                  : Read</pre>
 
1950
<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>
1951
1951
<p>The position of the opposite end of the selection from the cursor in chars.</p>
1952
1952
<p>Allowed values: &gt;= 0</p>
1953
1953
<p>Default value: 0</p>
1955
1955
<hr>
1956
1956
<div class="refsect2">
1957
1957
<a name="GtkLabel--single-line-mode"></a><h3>The <code class="literal">"single-line-mode"</code> property</h3>
1958
 
<pre class="programlisting">  "single-line-mode"         <span class="type">gboolean</span>              : Read / Write</pre>
 
1958
<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>
1959
1959
<p>
1960
1960
Whether the label is in single line mode. In single line mode,
1961
1961
the height of the label does not depend on the actual text, it
1969
1969
<hr>
1970
1970
<div class="refsect2">
1971
1971
<a name="GtkLabel--track-visited-links"></a><h3>The <code class="literal">"track-visited-links"</code> property</h3>
1972
 
<pre class="programlisting">  "track-visited-links"      <span class="type">gboolean</span>              : Read / Write</pre>
 
1972
<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>
1973
1973
<p>
1974
 
Set this property to <code class="literal">TRUE</code> to make the label track which links
 
1974
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
1975
1975
have been clicked. It will then apply the ::visited-link-color
1976
1976
color, instead of ::link-color.
1977
1977
</p>
1981
1981
<hr>
1982
1982
<div class="refsect2">
1983
1983
<a name="GtkLabel--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3>
1984
 
<pre class="programlisting">  "use-markup"               <span class="type">gboolean</span>              : Read / Write</pre>
 
1984
<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>
1985
1985
<p>The text of the label includes XML markup. See pango_parse_markup().</p>
1986
1986
<p>Default value: FALSE</p>
1987
1987
</div>
1988
1988
<hr>
1989
1989
<div class="refsect2">
1990
1990
<a name="GtkLabel--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>
1991
 
<pre class="programlisting">  "use-underline"            <span class="type">gboolean</span>              : Read / Write</pre>
 
1991
<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>
1992
1992
<p>If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key.</p>
1993
1993
<p>Default value: FALSE</p>
1994
1994
</div>
1995
1995
<hr>
1996
1996
<div class="refsect2">
1997
1997
<a name="GtkLabel--width-chars"></a><h3>The <code class="literal">"width-chars"</code> property</h3>
1998
 
<pre class="programlisting">  "width-chars"              <span class="type">gint</span>                  : Read / Write</pre>
 
1998
<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>
1999
1999
<p>
2000
2000
The desired width of the label, in characters. If this property is set to
2001
2001
-1, the width will be calculated automatically, otherwise the label will
2010
2010
<hr>
2011
2011
<div class="refsect2">
2012
2012
<a name="GtkLabel--wrap"></a><h3>The <code class="literal">"wrap"</code> property</h3>
2013
 
<pre class="programlisting">  "wrap"                     <span class="type">gboolean</span>              : Read / Write</pre>
 
2013
<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>
2014
2014
<p>If set, wrap lines if the text becomes too wide.</p>
2015
2015
<p>Default value: FALSE</p>
2016
2016
</div>
2017
2017
<hr>
2018
2018
<div class="refsect2">
2019
2019
<a name="GtkLabel--wrap-mode"></a><h3>The <code class="literal">"wrap-mode"</code> property</h3>
2020
 
<pre class="programlisting">  "wrap-mode"                <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a>         : Read / Write</pre>
 
2020
<pre class="programlisting">  "wrap-mode"                <span class="type">PangoWrapMode</span>         : Read / Write</pre>
2021
2021
<p>
2022
2022
If line wrapping is on (see the <a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'><span class="type">"wrap"</span></a> property) this controls 
2023
 
how the line wrapping is done. The default is <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-WRAP-WORD:CAPS"><code class="literal">PANGO_WRAP_WORD</code></a>, which 
 
2023
how the line wrapping is done. The default is <code class="literal">PANGO_WRAP_WORD</code>, which 
2024
2024
means wrap on word boundaries.
2025
2025
</p>
2026
2026
<p>Default value: PANGO_WRAP_WORD</p>
2032
2032
<div class="refsect2">
2033
2033
<a name="GtkLabel-activate-current-link"></a><h3>The <code class="literal">"activate-current-link"</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> *label,
2035
 
                                                        <span class="type">gpointer</span>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 
2035
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
2036
2036
<p>
2037
2037
A <a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
2038
2038
which gets emitted when the user activates a link in the label.
2065
2065
<hr>
2066
2066
<div class="refsect2">
2067
2067
<a name="GtkLabel-activate-link"></a><h3>The <code class="literal">"activate-link"</code> signal</h3>
2068
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            user_function                      (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label,
2069
 
                                                        <span class="type">gchar</span>    *uri,
2070
 
                                                        <span class="type">gpointer</span>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
2068
<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,
 
2069
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>    *uri,
 
2070
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
2071
2071
<p>
2072
2072
The signal which gets emitted to activate a URI.
2073
2073
Applications may connect to it to override the default behaviour,
2094
2094
<tr>
2095
2095
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2096
2096
<td>
2097
 
<code class="literal">TRUE</code> if the link has been activated</td>
 
2097
<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</td>
2098
2098
</tr>
2099
2099
</tbody>
2100
2100
</table></div>
2104
2104
<div class="refsect2">
2105
2105
<a name="GtkLabel-copy-clipboard"></a><h3>The <code class="literal">"copy-clipboard"</code> signal</h3>
2106
2106
<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,
2107
 
                                                        <span class="type">gpointer</span>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 
2107
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
2108
2108
<p>
2109
2109
The ::copy-clipboard signal is a
2110
2110
<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
2135
2135
<a name="GtkLabel-move-cursor"></a><h3>The <code class="literal">"move-cursor"</code> signal</h3>
2136
2136
<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,
2137
2137
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step,
2138
 
                                                        <span class="type">gint</span>            count,
2139
 
                                                        <span class="type">gboolean</span>        extend_selection,
2140
 
                                                        <span class="type">gpointer</span>        user_data)             : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 
2138
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>            count,
 
2139
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>        extend_selection,
 
2140
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)             : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
2141
2141
<p>
2142
2142
The ::move-cursor signal is a
2143
2143
<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
2185
2185
<tr>
2186
2186
<td><p><span class="term"><em class="parameter"><code>extend_selection</code></em> :</span></p></td>
2187
2187
<td>
2188
 
<code class="literal">TRUE</code> if the move should extend the selection</td>
 
2188
<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</td>
2189
2189
</tr>
2190
2190
<tr>
2191
2191
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2199
2199
<a name="GtkLabel-populate-popup"></a><h3>The <code class="literal">"populate-popup"</code> signal</h3>
2200
2200
<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,
2201
2201
                                                        <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>  *menu,
2202
 
                                                        <span class="type">gpointer</span>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
2202
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>  user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
2203
2203
<p>
2204
2204
The ::populate-popup signal gets emitted before showing the
2205
2205
context menu of the label. Note that only selectable labels