← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2011-09-08 20:30:15 UTC
  • mfrom: (1.14.10 upstream)
  • Revision ID: package-import@ubuntu.com-20110908203015-hmdoq5jt1bl50nq3
Tags: 2.24.6-0ubuntu1
* debian/watch: Look for bz2 tarballs, and restrict to GTK 2 versions.
* New upstream bug fix release.
* Drop 094_git_fileselector_error.patch, include_m4_dir.patch: Included
  upstream.
* 003_gdk.pc_privates.patch, 009_gtk-export-filechooser.patch: Unfuzz.
* debian/libgail-doc.install, debian/libgtk2.0-doc.install.in: Install
  documentation from the source tree, as it's not being installed any more.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkButton.html
52
52
 
53
53
struct              <a class="link" href="GtkButton.html#GtkButton-struct" title="struct GtkButton">GtkButton</a>;
54
54
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new" title="gtk_button_new ()">gtk_button_new</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
55
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-with-label" title="gtk_button_new_with_label ()">gtk_button_new_with_label</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> *label</code></em>);
56
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-with-mnemonic" title="gtk_button_new_with_mnemonic ()">gtk_button_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> *label</code></em>);
57
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-from-stock" title="gtk_button_new_from_stock ()">gtk_button_new_from_stock</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> *stock_id</code></em>);
 
55
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-with-label" title="gtk_button_new_with_label ()">gtk_button_new_with_label</a>           (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
 
56
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-with-mnemonic" title="gtk_button_new_with_mnemonic ()">gtk_button_new_with_mnemonic</a>        (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
 
57
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-new-from-stock" title="gtk_button_new_from_stock ()">gtk_button_new_from_stock</a>           (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-pressed" title="gtk_button_pressed ()">gtk_button_pressed</a>                  (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
59
59
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-released" title="gtk_button_released ()">gtk_button_released</a>                 (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
60
60
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-clicked" title="gtk_button_clicked ()">gtk_button_clicked</a>                  (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-relief" title="gtk_button_set_relief ()">gtk_button_set_relief</a>               (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
64
64
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a> newstyle</code></em>);
65
65
<a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      <a class="link" href="GtkButton.html#gtk-button-get-relief" title="gtk_button_get_relief ()">gtk_button_get_relief</a>               (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
66
 
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="GtkButton.html#gtk-button-get-label" title="gtk_button_get_label ()">gtk_button_get_label</a>                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
 
66
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkButton.html#gtk-button-get-label" title="gtk_button_get_label ()">gtk_button_get_label</a>                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
67
67
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-label" title="gtk_button_set_label ()">gtk_button_set_label</a>                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
68
 
                                                         <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> *label</code></em>);
69
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkButton.html#gtk-button-get-use-stock" title="gtk_button_get_use_stock ()">gtk_button_get_use_stock</a>            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
 
68
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
 
69
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkButton.html#gtk-button-get-use-stock" title="gtk_button_get_use_stock ()">gtk_button_get_use_stock</a>            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
70
70
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-use-stock" title="gtk_button_set_use_stock ()">gtk_button_set_use_stock</a>            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
71
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_stock</code></em>);
72
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkButton.html#gtk-button-get-use-underline" title="gtk_button_get_use_underline ()">gtk_button_get_use_underline</a>        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
 
71
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_stock</code></em>);
 
72
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkButton.html#gtk-button-get-use-underline" title="gtk_button_get_use_underline ()">gtk_button_get_use_underline</a>        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
73
73
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-use-underline" title="gtk_button_set_use_underline ()">gtk_button_set_use_underline</a>        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
74
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);
 
74
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_underline</code></em>);
75
75
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-focus-on-click" title="gtk_button_set_focus_on_click ()">gtk_button_set_focus_on_click</a>       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</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> focus_on_click</code></em>);
77
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkButton.html#gtk-button-get-focus-on-click" title="gtk_button_get_focus_on_click ()">gtk_button_get_focus_on_click</a>       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
 
76
                                                         <em class="parameter"><code><span class="type">gboolean</span> focus_on_click</code></em>);
 
77
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkButton.html#gtk-button-get-focus-on-click" title="gtk_button_get_focus_on_click ()">gtk_button_get_focus_on_click</a>       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
78
78
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-alignment" title="gtk_button_set_alignment ()">gtk_button_set_alignment</a>            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
79
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
80
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>);
 
79
                                                         <em class="parameter"><code><span class="type">gfloat</span> xalign</code></em>,
 
80
                                                         <em class="parameter"><code><span class="type">gfloat</span> yalign</code></em>);
81
81
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-get-alignment" title="gtk_button_get_alignment ()">gtk_button_get_alignment</a>            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
82
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *xalign</code></em>,
83
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *yalign</code></em>);
 
82
                                                         <em class="parameter"><code><span class="type">gfloat</span> *xalign</code></em>,
 
83
                                                         <em class="parameter"><code><span class="type">gfloat</span> *yalign</code></em>);
84
84
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-image" title="gtk_button_set_image ()">gtk_button_set_image</a>                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
85
85
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *image</code></em>);
86
86
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkButton.html#gtk-button-get-image" title="gtk_button_get_image ()">gtk_button_get_image</a>                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
87
87
<span class="returnvalue">void</span>                <a class="link" href="GtkButton.html#gtk-button-set-image-position" title="gtk_button_set_image_position ()">gtk_button_set_image_position</a>       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
88
88
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a> position</code></em>);
89
89
<a class="link" href="gtk-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="returnvalue">GtkPositionType</span></a>     <a class="link" href="GtkButton.html#gtk-button-get-image-position" title="gtk_button_get_image_position ()">gtk_button_get_image_position</a>       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
90
 
<a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="GtkButton.html#gtk-button-get-event-window" title="gtk_button_get_event_window ()">gtk_button_get_event_window</a>         (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
 
90
<a href="../gdk/gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="GtkButton.html#gtk-button-get-event-window" title="gtk_button_get_event_window ()">gtk_button_get_event_window</a>         (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);
91
91
</pre>
92
92
</div>
93
93
<div class="refsect1">
94
94
<a name="GtkButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
95
95
<pre class="synopsis">
96
 
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
97
 
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
96
  GObject
 
97
   +----GInitiallyUnowned
98
98
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
99
99
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
100
100
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
117
117
<div class="refsect1">
118
118
<a name="GtkButton.properties"></a><h2>Properties</h2>
119
119
<pre class="synopsis">
120
 
  "<a class="link" href="GtkButton.html#GtkButton--focus-on-click" title='The "focus-on-click" property'>focus-on-click</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
120
  "<a class="link" href="GtkButton.html#GtkButton--focus-on-click" title='The "focus-on-click" property'>focus-on-click</a>"           <span class="type">gboolean</span>              : Read / Write
121
121
  "<a class="link" href="GtkButton.html#GtkButton--image" title='The "image" property'>image</a>"                    <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
122
122
  "<a class="link" href="GtkButton.html#GtkButton--image-position" title='The "image-position" property'>image-position</a>"           <a class="link" href="gtk-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a>       : Read / Write
123
 
  "<a class="link" href="GtkButton.html#GtkButton--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 / Construct
 
123
  "<a class="link" href="GtkButton.html#GtkButton--label" title='The "label" property'>label</a>"                    <span class="type">gchar</span>*                : Read / Write / Construct
124
124
  "<a class="link" href="GtkButton.html#GtkButton--relief" title='The "relief" property'>relief</a>"                   <a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>        : Read / Write
125
 
  "<a class="link" href="GtkButton.html#GtkButton--use-stock" title='The "use-stock" property'>use-stock</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
126
 
  "<a class="link" href="GtkButton.html#GtkButton--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 / Construct
127
 
  "<a class="link" href="GtkButton.html#GtkButton--xalign" title='The "xalign" property'>xalign</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
128
 
  "<a class="link" href="GtkButton.html#GtkButton--yalign" title='The "yalign" property'>yalign</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
 
125
  "<a class="link" href="GtkButton.html#GtkButton--use-stock" title='The "use-stock" property'>use-stock</a>"                <span class="type">gboolean</span>              : Read / Write / Construct
 
126
  "<a class="link" href="GtkButton.html#GtkButton--use-underline" title='The "use-underline" property'>use-underline</a>"            <span class="type">gboolean</span>              : Read / Write / Construct
 
127
  "<a class="link" href="GtkButton.html#GtkButton--xalign" title='The "xalign" property'>xalign</a>"                   <span class="type">gfloat</span>                : Read / Write
 
128
  "<a class="link" href="GtkButton.html#GtkButton--yalign" title='The "yalign" property'>yalign</a>"                   <span class="type">gfloat</span>                : Read / Write
129
129
</pre>
130
130
</div>
131
131
<div class="refsect1">
132
132
<a name="GtkButton.style-properties"></a><h2>Style Properties</h2>
133
133
<pre class="synopsis">
134
 
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-x" title='The "child-displacement-x" style property'>child-displacement-x</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
135
 
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-y" title='The "child-displacement-y" style property'>child-displacement-y</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
134
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-x" title='The "child-displacement-x" style property'>child-displacement-x</a>"     <span class="type">gint</span>                  : Read
 
135
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-y" title='The "child-displacement-y" style property'>child-displacement-y</a>"     <span class="type">gint</span>                  : Read
136
136
  "<a class="link" href="GtkButton.html#GtkButton--s-default-border" title='The "default-border" style property'>default-border</a>"           <a class="link" href="GtkStyle.html#GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
137
137
  "<a class="link" href="GtkButton.html#GtkButton--s-default-outside-border" title='The "default-outside-border" style property'>default-outside-border</a>"   <a class="link" href="GtkStyle.html#GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
138
 
  "<a class="link" href="GtkButton.html#GtkButton--s-displace-focus" title='The "displace-focus" style property'>displace-focus</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
139
 
  "<a class="link" href="GtkButton.html#GtkButton--s-image-spacing" title='The "image-spacing" style property'>image-spacing</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
138
  "<a class="link" href="GtkButton.html#GtkButton--s-displace-focus" title='The "displace-focus" style property'>displace-focus</a>"           <span class="type">gboolean</span>              : Read
 
139
  "<a class="link" href="GtkButton.html#GtkButton--s-image-spacing" title='The "image-spacing" style property'>image-spacing</a>"            <span class="type">gint</span>                  : Read
140
140
  "<a class="link" href="GtkButton.html#GtkButton--s-inner-border" title='The "inner-border" style property'>inner-border</a>"             <a class="link" href="GtkStyle.html#GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
141
141
</pre>
142
142
</div>
143
143
<div class="refsect1">
144
144
<a name="GtkButton.signals"></a><h2>Signals</h2>
145
145
<pre class="synopsis">
146
 
  "<a class="link" href="GtkButton.html#GtkButton-activate" title='The "activate" signal'>activate</a>"                                       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
147
 
  "<a class="link" href="GtkButton.html#GtkButton-clicked" title='The "clicked" signal'>clicked</a>"                                        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
148
 
  "<a class="link" href="GtkButton.html#GtkButton-enter" title='The "enter" signal'>enter</a>"                                          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
149
 
  "<a class="link" href="GtkButton.html#GtkButton-leave" title='The "leave" signal'>leave</a>"                                          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
150
 
  "<a class="link" href="GtkButton.html#GtkButton-pressed" title='The "pressed" signal'>pressed</a>"                                        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
151
 
  "<a class="link" href="GtkButton.html#GtkButton-released" title='The "released" signal'>released</a>"                                       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
 
146
  "<a class="link" href="GtkButton.html#GtkButton-activate" title='The "activate" signal'>activate</a>"                                       : <code class="literal">Action</code>
 
147
  "<a class="link" href="GtkButton.html#GtkButton-clicked" title='The "clicked" signal'>clicked</a>"                                        : <code class="literal">Action</code>
 
148
  "<a class="link" href="GtkButton.html#GtkButton-enter" title='The "enter" signal'>enter</a>"                                          : <code class="literal">Run First</code>
 
149
  "<a class="link" href="GtkButton.html#GtkButton-leave" title='The "leave" signal'>leave</a>"                                          : <code class="literal">Run First</code>
 
150
  "<a class="link" href="GtkButton.html#GtkButton-pressed" title='The "pressed" signal'>pressed</a>"                                        : <code class="literal">Run First</code>
 
151
  "<a class="link" href="GtkButton.html#GtkButton-released" title='The "released" signal'>released</a>"                                       : <code class="literal">Run First</code>
152
152
</pre>
153
153
</div>
154
154
<div class="refsect1">
192
192
<hr>
193
193
<div class="refsect2">
194
194
<a name="gtk-button-new-with-label"></a><h3>gtk_button_new_with_label ()</h3>
195
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_new_with_label           (<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> *label</code></em>);</pre>
 
195
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_new_with_label           (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
196
196
<p>
197
197
Creates a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> widget with a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> child containing the given
198
198
text.
214
214
<hr>
215
215
<div class="refsect2">
216
216
<a name="gtk-button-new-with-mnemonic"></a><h3>gtk_button_new_with_mnemonic ()</h3>
217
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_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> *label</code></em>);</pre>
 
217
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_new_with_mnemonic        (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
218
218
<p>
219
219
Creates a new <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> containing a label.
220
220
If characters in <em class="parameter"><code>label</code></em> are preceded by an underscore, they are underlined.
242
242
<hr>
243
243
<div class="refsect2">
244
244
<a name="gtk-button-new-from-stock"></a><h3>gtk_button_new_from_stock ()</h3>
245
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_new_from_stock           (<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> *stock_id</code></em>);</pre>
 
245
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_button_new_from_stock           (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
246
246
<p>
247
247
Creates a new <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> containing the image and text from a stock item.
248
248
Some stock ids have preprocessor macros like <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><span class="type">GTK_STOCK_OK</span></a> and
408
408
<hr>
409
409
<div class="refsect2">
410
410
<a name="gtk-button-get-label"></a><h3>gtk_button_get_label ()</h3>
411
 
<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_button_get_label                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
 
411
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_button_get_label                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
412
412
<p>
413
413
Fetches the text from the label of the button, as set by
414
414
<a class="link" href="GtkButton.html#gtk-button-set-label" title="gtk_button_set_label ()"><code class="function">gtk_button_set_label()</code></a>. If the label text has not 
415
 
been set the return value will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This will be the 
 
415
been set the return value will be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. This will be the 
416
416
case if you create an empty button with <a class="link" href="GtkButton.html#gtk-button-new" title="gtk_button_new ()"><code class="function">gtk_button_new()</code></a> to 
417
417
use as a container.
418
418
</p>
436
436
<div class="refsect2">
437
437
<a name="gtk-button-set-label"></a><h3>gtk_button_set_label ()</h3>
438
438
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_set_label                (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
439
 
                                                         <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> *label</code></em>);</pre>
 
439
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
440
440
<p>
441
441
Sets the text of the label of the button to <em class="parameter"><code>str</code></em>. This text is
442
442
also used to select the stock item if <a class="link" href="GtkButton.html#gtk-button-set-use-stock" title="gtk_button_set_use_stock ()"><code class="function">gtk_button_set_use_stock()</code></a>
463
463
<hr>
464
464
<div class="refsect2">
465
465
<a name="gtk-button-get-use-stock"></a><h3>gtk_button_get_use_stock ()</h3>
466
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_button_get_use_stock            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
 
466
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_button_get_use_stock            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
467
467
<p>
468
468
Returns whether the button label is a stock item.
469
469
</p>
478
478
<tr>
479
479
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
480
480
<td>
481
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button label is used to
 
481
<code class="literal">TRUE</code> if the button label is used to
482
482
select a stock item instead of being
483
483
used directly as the label text.</td>
484
484
</tr>
489
489
<div class="refsect2">
490
490
<a name="gtk-button-set-use-stock"></a><h3>gtk_button_set_use_stock ()</h3>
491
491
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_set_use_stock            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
492
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_stock</code></em>);</pre>
 
492
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_stock</code></em>);</pre>
493
493
<p>
494
 
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the label set on the button is used as a
 
494
If <code class="literal">TRUE</code>, the label set on the button is used as a
495
495
stock id to select the stock item for the button.
496
496
</p>
497
497
<div class="variablelist"><table border="0">
505
505
<tr>
506
506
<td><p><span class="term"><em class="parameter"><code>use_stock</code></em> :</span></p></td>
507
507
<td>
508
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button should use a stock item</td>
 
508
<code class="literal">TRUE</code> if the button should use a stock item</td>
509
509
</tr>
510
510
</tbody>
511
511
</table></div>
513
513
<hr>
514
514
<div class="refsect2">
515
515
<a name="gtk-button-get-use-underline"></a><h3>gtk_button_get_use_underline ()</h3>
516
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_button_get_use_underline        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
 
516
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_button_get_use_underline        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
517
517
<p>
518
518
Returns whether an embedded underline in the button label indicates a
519
519
mnemonic. See <a class="link" href="GtkButton.html#gtk-button-set-use-underline" title="gtk_button_set_use_underline ()"><code class="function">gtk_button_set_use_underline()</code></a>.
529
529
<tr>
530
530
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
531
531
<td>
532
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an embedded underline in the button label
 
532
<code class="literal">TRUE</code> if an embedded underline in the button label
533
533
indicates the mnemonic accelerator keys.</td>
534
534
</tr>
535
535
</tbody>
539
539
<div class="refsect2">
540
540
<a name="gtk-button-set-use-underline"></a><h3>gtk_button_set_use_underline ()</h3>
541
541
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_set_use_underline        (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
542
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);</pre>
 
542
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_underline</code></em>);</pre>
543
543
<p>
544
544
If true, an underline in the text of the button label indicates
545
545
the next character should be used for the mnemonic accelerator key.
555
555
<tr>
556
556
<td><p><span class="term"><em class="parameter"><code>use_underline</code></em> :</span></p></td>
557
557
<td>
558
 
<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>
 
558
<code class="literal">TRUE</code> if underlines in the text indicate mnemonics</td>
559
559
</tr>
560
560
</tbody>
561
561
</table></div>
564
564
<div class="refsect2">
565
565
<a name="gtk-button-set-focus-on-click"></a><h3>gtk_button_set_focus_on_click ()</h3>
566
566
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_set_focus_on_click       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
567
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> focus_on_click</code></em>);</pre>
 
567
                                                         <em class="parameter"><code><span class="type">gboolean</span> focus_on_click</code></em>);</pre>
568
568
<p>
569
569
Sets whether the button will grab focus when it is clicked with the mouse.
570
570
Making mouse clicks not grab focus is useful in places like toolbars where
590
590
<hr>
591
591
<div class="refsect2">
592
592
<a name="gtk-button-get-focus-on-click"></a><h3>gtk_button_get_focus_on_click ()</h3>
593
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_button_get_focus_on_click       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
 
593
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_button_get_focus_on_click       (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
594
594
<p>
595
595
Returns whether the button grabs focus when it is clicked with the mouse.
596
596
See <a class="link" href="GtkButton.html#gtk-button-set-focus-on-click" title="gtk_button_set_focus_on_click ()"><code class="function">gtk_button_set_focus_on_click()</code></a>.
606
606
<tr>
607
607
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
608
608
<td>
609
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button grabs focus when it is clicked with
 
609
<code class="literal">TRUE</code> if the button grabs focus when it is clicked with
610
610
the mouse.</td>
611
611
</tr>
612
612
</tbody>
617
617
<div class="refsect2">
618
618
<a name="gtk-button-set-alignment"></a><h3>gtk_button_set_alignment ()</h3>
619
619
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_set_alignment            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
620
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
621
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>);</pre>
 
620
                                                         <em class="parameter"><code><span class="type">gfloat</span> xalign</code></em>,
 
621
                                                         <em class="parameter"><code><span class="type">gfloat</span> yalign</code></em>);</pre>
622
622
<p>
623
623
Sets the alignment of the child. This property has no effect unless 
624
624
the child is a <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> or a <span class="type">GtkAligment</span>.
649
649
<div class="refsect2">
650
650
<a name="gtk-button-get-alignment"></a><h3>gtk_button_get_alignment ()</h3>
651
651
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_button_get_alignment            (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>,
652
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *xalign</code></em>,
653
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *yalign</code></em>);</pre>
 
652
                                                         <em class="parameter"><code><span class="type">gfloat</span> *xalign</code></em>,
 
653
                                                         <em class="parameter"><code><span class="type">gfloat</span> *yalign</code></em>);</pre>
654
654
<p>
655
655
Gets the alignment of the child in the button.
656
656
</p>
722
722
</tr>
723
723
<tr>
724
724
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
725
 
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case there is no image. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
725
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> in case there is no image. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
726
726
</td>
727
727
</tr>
728
728
</tbody>
781
781
<hr>
782
782
<div class="refsect2">
783
783
<a name="gtk-button-get-event-window"></a><h3>gtk_button_get_event_window ()</h3>
784
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gtk_button_get_event_window         (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
 
784
<pre class="programlisting"><a href="../gdk/gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gtk_button_get_event_window         (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
785
785
<p>
786
 
Returns the button's event window if it is realized, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.
 
786
Returns the button's event window if it is realized, <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> otherwise.
787
787
This function should be rarely needed.
788
788
</p>
789
789
<div class="variablelist"><table border="0">
809
809
<a name="GtkButton.property-details"></a><h2>Property Details</h2>
810
810
<div class="refsect2">
811
811
<a name="GtkButton--focus-on-click"></a><h3>The <code class="literal">"focus-on-click"</code> property</h3>
812
 
<pre class="programlisting">  "focus-on-click"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
812
<pre class="programlisting">  "focus-on-click"           <span class="type">gboolean</span>              : Read / Write</pre>
813
813
<p>Whether the button grabs focus when it is clicked with the mouse.</p>
814
814
<p>Default value: TRUE</p>
815
815
</div>
832
832
<hr>
833
833
<div class="refsect2">
834
834
<a name="GtkButton--label"></a><h3>The <code class="literal">"label"</code> property</h3>
835
 
<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 / Construct</pre>
 
835
<pre class="programlisting">  "label"                    <span class="type">gchar</span>*                : Read / Write / Construct</pre>
836
836
<p>Text of the label widget inside the button, if the button contains a label widget.</p>
837
837
<p>Default value: NULL</p>
838
838
</div>
846
846
<hr>
847
847
<div class="refsect2">
848
848
<a name="GtkButton--use-stock"></a><h3>The <code class="literal">"use-stock"</code> property</h3>
849
 
<pre class="programlisting">  "use-stock"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
 
849
<pre class="programlisting">  "use-stock"                <span class="type">gboolean</span>              : Read / Write / Construct</pre>
850
850
<p>If set, the label is used to pick a stock item instead of being displayed.</p>
851
851
<p>Default value: FALSE</p>
852
852
</div>
853
853
<hr>
854
854
<div class="refsect2">
855
855
<a name="GtkButton--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>
856
 
<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 / Construct</pre>
 
856
<pre class="programlisting">  "use-underline"            <span class="type">gboolean</span>              : Read / Write / Construct</pre>
857
857
<p>If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key.</p>
858
858
<p>Default value: FALSE</p>
859
859
</div>
860
860
<hr>
861
861
<div class="refsect2">
862
862
<a name="GtkButton--xalign"></a><h3>The <code class="literal">"xalign"</code> property</h3>
863
 
<pre class="programlisting">  "xalign"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
 
863
<pre class="programlisting">  "xalign"                   <span class="type">gfloat</span>                : Read / Write</pre>
864
864
<p>
865
865
If the child of the button is a <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> or <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>, this property
866
866
can be used to control it's horizontal alignment. 0.0 is left aligned, 
873
873
<hr>
874
874
<div class="refsect2">
875
875
<a name="GtkButton--yalign"></a><h3>The <code class="literal">"yalign"</code> property</h3>
876
 
<pre class="programlisting">  "yalign"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
 
876
<pre class="programlisting">  "yalign"                   <span class="type">gfloat</span>                : Read / Write</pre>
877
877
<p>
878
878
If the child of the button is a <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> or <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a>, this property 
879
879
can be used to control it's vertical alignment. 0.0 is top aligned, 
888
888
<a name="GtkButton.style-property-details"></a><h2>Style Property Details</h2>
889
889
<div class="refsect2">
890
890
<a name="GtkButton--s-child-displacement-x"></a><h3>The <code class="literal">"child-displacement-x"</code> style property</h3>
891
 
<pre class="programlisting">  "child-displacement-x"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
891
<pre class="programlisting">  "child-displacement-x"     <span class="type">gint</span>                  : Read</pre>
892
892
<p>How far in the x direction to move the child when the button is depressed.</p>
893
893
<p>Default value: 0</p>
894
894
</div>
895
895
<hr>
896
896
<div class="refsect2">
897
897
<a name="GtkButton--s-child-displacement-y"></a><h3>The <code class="literal">"child-displacement-y"</code> style property</h3>
898
 
<pre class="programlisting">  "child-displacement-y"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
898
<pre class="programlisting">  "child-displacement-y"     <span class="type">gint</span>                  : Read</pre>
899
899
<p>How far in the y direction to move the child when the button is depressed.</p>
900
900
<p>Default value: 0</p>
901
901
</div>
923
923
<hr>
924
924
<div class="refsect2">
925
925
<a name="GtkButton--s-displace-focus"></a><h3>The <code class="literal">"displace-focus"</code> style property</h3>
926
 
<pre class="programlisting">  "displace-focus"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 
926
<pre class="programlisting">  "displace-focus"           <span class="type">gboolean</span>              : Read</pre>
927
927
<p>
928
928
Whether the child_displacement_x/child_displacement_y properties
929
929
should also affect the focus rectangle.
934
934
<hr>
935
935
<div class="refsect2">
936
936
<a name="GtkButton--s-image-spacing"></a><h3>The <code class="literal">"image-spacing"</code> style property</h3>
937
 
<pre class="programlisting">  "image-spacing"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
937
<pre class="programlisting">  "image-spacing"            <span class="type">gint</span>                  : Read</pre>
938
938
<p>Spacing in pixels between the image and label.</p>
939
939
<p>Allowed values: &gt;= 0</p>
940
940
<p>Default value: 2</p>
954
954
<div class="refsect2">
955
955
<a name="GtkButton-activate"></a><h3>The <code class="literal">"activate"</code> signal</h3>
956
956
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *widget,
957
 
                                                        <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>
 
957
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Action</code></pre>
958
958
<p>
959
959
The ::activate signal on GtkButton is an action signal and
960
960
emitting it causes the button to animate press then release.
979
979
<div class="refsect2">
980
980
<a name="GtkButton-clicked"></a><h3>The <code class="literal">"clicked"</code> signal</h3>
981
981
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button,
982
 
                                                        <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>
 
982
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Action</code></pre>
983
983
<p>
984
984
Emitted when the button has been activated (pressed and released).
985
985
</p>
1001
1001
<div class="refsect2">
1002
1002
<a name="GtkButton-enter"></a><h3>The <code class="literal">"enter"</code> signal</h3>
1003
1003
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button,
1004
 
                                                        <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-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1004
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run First</code></pre>
1005
1005
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1006
1006
<h3 class="title">Warning</h3>
1007
1007
<p><code class="literal">GtkButton::enter</code> has been deprecated since version 2.8 and should not be used in newly-written code. Use the <a class="link" href="GtkWidget.html#GtkWidget-enter-notify-event" title='The "enter-notify-event" signal'><span class="type">"enter-notify-event"</span></a> signal.</p>
1027
1027
<div class="refsect2">
1028
1028
<a name="GtkButton-leave"></a><h3>The <code class="literal">"leave"</code> signal</h3>
1029
1029
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button,
1030
 
                                                        <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-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1030
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run First</code></pre>
1031
1031
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1032
1032
<h3 class="title">Warning</h3>
1033
1033
<p><code class="literal">GtkButton::leave</code> has been deprecated since version 2.8 and should not be used in newly-written code. Use the <a class="link" href="GtkWidget.html#GtkWidget-leave-notify-event" title='The "leave-notify-event" signal'><span class="type">"leave-notify-event"</span></a> signal.</p>
1053
1053
<div class="refsect2">
1054
1054
<a name="GtkButton-pressed"></a><h3>The <code class="literal">"pressed"</code> signal</h3>
1055
1055
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button,
1056
 
                                                        <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-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1056
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run First</code></pre>
1057
1057
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1058
1058
<h3 class="title">Warning</h3>
1059
1059
<p><code class="literal">GtkButton::pressed</code> has been deprecated since version 2.8 and should not be used in newly-written code. Use the <a class="link" href="GtkWidget.html#GtkWidget-button-press-event" title='The "button-press-event" signal'><span class="type">"button-press-event"</span></a> signal.</p>
1079
1079
<div class="refsect2">
1080
1080
<a name="GtkButton-released"></a><h3>The <code class="literal">"released"</code> signal</h3>
1081
1081
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button,
1082
 
                                                        <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-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1082
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run First</code></pre>
1083
1083
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1084
1084
<h3 class="title">Warning</h3>
1085
1085
<p><code class="literal">GtkButton::released</code> has been deprecated since version 2.8 and should not be used in newly-written code. Use the <a class="link" href="GtkWidget.html#GtkWidget-button-release-event" title='The "button-release-event" signal'><span class="type">"button-release-event"</span></a> signal.</p>