← Back to branch summary

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

« back to all changes in this revision

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

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

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkButton.html
52
52
 
53
53
                    <a class="link" href="GtkButton.html#GtkButton-struct" title="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="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/glib/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 <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>);
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="/usr/share/gtk-doc/html/glib/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 <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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
69
 
<a href="/usr/share/gtk-doc/html/glib/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 <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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_stock</code></em>);
72
 
<a href="/usr/share/gtk-doc/html/glib/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><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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> focus_on_click</code></em>);
77
 
<a href="/usr/share/gtk-doc/html/glib/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><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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
80
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</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>);
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *xalign</code></em>,
83
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *yalign</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>);
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>);
92
92
<div class="refsect1" title="Object Hierarchy">
93
93
<a name="GtkButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
94
94
<pre class="synopsis">
95
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
96
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
95
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
96
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
97
97
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
98
98
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
99
99
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
116
116
<div class="refsect1" title="Properties">
117
117
<a name="GtkButton.properties"></a><h2>Properties</h2>
118
118
<pre class="synopsis">
119
 
  "<a class="link" href="GtkButton.html#GtkButton--focus-on-click" title='The "focus-on-click" property'>focus-on-click</a>"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
119
  "<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
120
  "<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
121
121
  "<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
122
 
  "<a class="link" href="GtkButton.html#GtkButton--label" title='The "label" property'>label</a>"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct
 
122
  "<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
123
  "<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
124
 
  "<a class="link" href="GtkButton.html#GtkButton--use-stock" title='The "use-stock" property'>use-stock</a>"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
125
 
  "<a class="link" href="GtkButton.html#GtkButton--use-underline" title='The "use-underline" property'>use-underline</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
126
 
  "<a class="link" href="GtkButton.html#GtkButton--xalign" title='The "xalign" property'>xalign</a>"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
127
 
  "<a class="link" href="GtkButton.html#GtkButton--yalign" title='The "yalign" property'>yalign</a>"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
 
124
  "<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
 
125
  "<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
 
126
  "<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
 
127
  "<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
128
128
</pre>
129
129
</div>
130
130
<div class="refsect1" title="Style Properties">
131
131
<a name="GtkButton.style-properties"></a><h2>Style Properties</h2>
132
132
<pre class="synopsis">
133
 
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-x" title='The "child-displacement-x" style property'>child-displacement-x</a>"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
134
 
  "<a class="link" href="GtkButton.html#GtkButton--s-child-displacement-y" title='The "child-displacement-y" style property'>child-displacement-y</a>"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
133
  "<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
 
134
  "<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
135
135
  "<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" title="GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
136
136
  "<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" title="GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
137
 
  "<a class="link" href="GtkButton.html#GtkButton--s-displace-focus" title='The "displace-focus" style property'>displace-focus</a>"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
138
 
  "<a class="link" href="GtkButton.html#GtkButton--s-image-spacing" title='The "image-spacing" style property'>image-spacing</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
137
  "<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
 
138
  "<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
139
139
  "<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" title="GtkBorder"><span class="type">GtkBorder</span></a>*            : Read
140
140
</pre>
141
141
</div>
192
192
<hr>
193
193
<div class="refsect2" title="gtk_button_new_with_label ()">
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="/usr/share/gtk-doc/html/glib/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 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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.
216
216
<hr>
217
217
<div class="refsect2" title="gtk_button_new_with_mnemonic ()">
218
218
<a name="gtk-button-new-with-mnemonic"></a><h3>gtk_button_new_with_mnemonic ()</h3>
219
 
<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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
219
<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>
220
220
<p>
221
221
Creates a new <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> containing a label.
222
222
If characters in <em class="parameter"><code>label</code></em> are preceded by an underscore, they are underlined.
245
245
<hr>
246
246
<div class="refsect2" title="gtk_button_new_from_stock ()">
247
247
<a name="gtk-button-new-from-stock"></a><h3>gtk_button_new_from_stock ()</h3>
248
 
<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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
 
248
<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>
249
249
<p>
250
250
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.
251
251
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
420
420
<hr>
421
421
<div class="refsect2" title="gtk_button_get_label ()">
422
422
<a name="gtk-button-get-label"></a><h3>gtk_button_get_label ()</h3>
423
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/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>
 
423
<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>
424
424
<p>
425
425
Fetches the text from the label of the button, as set by
426
426
<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 
427
 
been set the return value will be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. This will be the 
 
427
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 
428
428
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 
429
429
use as a container.
430
430
</p>
449
449
<div class="refsect2" title="gtk_button_set_label ()">
450
450
<a name="gtk-button-set-label"></a><h3>gtk_button_set_label ()</h3>
451
451
<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>,
452
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
452
                                                         <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>
453
453
<p>
454
454
Sets the text of the label of the button to <em class="parameter"><code>str</code></em>. This text is
455
455
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>
477
477
<hr>
478
478
<div class="refsect2" title="gtk_button_get_use_stock ()">
479
479
<a name="gtk-button-get-use-stock"></a><h3>gtk_button_get_use_stock ()</h3>
480
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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>
 
480
<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>
481
481
<p>
482
482
Returns whether the button label is a stock item.
483
483
</p>
491
491
</tr>
492
492
<tr>
493
493
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
494
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button label is used to
 
494
<td> <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
495
495
              select a stock item instead of being
496
496
              used directly as the label text.
497
497
</td>
503
503
<div class="refsect2" title="gtk_button_set_use_stock ()">
504
504
<a name="gtk-button-set-use-stock"></a><h3>gtk_button_set_use_stock ()</h3>
505
505
<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>,
506
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_stock</code></em>);</pre>
 
506
                                                         <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>
507
507
<p>
508
 
If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the label set on the button is used as a
 
508
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
509
509
stock id to select the stock item for the button.
510
510
</p>
511
511
<div class="variablelist"><table border="0">
519
519
<tr>
520
520
<td><p><span class="term"><em class="parameter"><code>use_stock</code></em> :</span></p></td>
521
521
<td>
522
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button should use a stock item
 
522
<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
523
523
</td>
524
524
</tr>
525
525
</tbody>
528
528
<hr>
529
529
<div class="refsect2" title="gtk_button_get_use_underline ()">
530
530
<a name="gtk-button-get-use-underline"></a><h3>gtk_button_get_use_underline ()</h3>
531
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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>
 
531
<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>
532
532
<p>
533
533
Returns whether an embedded underline in the button label indicates a
534
534
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>.
543
543
</tr>
544
544
<tr>
545
545
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
546
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an embedded underline in the button label
 
546
<td> <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
547
547
              indicates the mnemonic accelerator keys.
548
548
</td>
549
549
</tr>
554
554
<div class="refsect2" title="gtk_button_set_use_underline ()">
555
555
<a name="gtk-button-set-use-underline"></a><h3>gtk_button_set_use_underline ()</h3>
556
556
<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>,
557
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_underline</code></em>);</pre>
 
557
                                                         <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>
558
558
<p>
559
559
If true, an underline in the text of the button label indicates
560
560
the next character should be used for the mnemonic accelerator key.
570
570
<tr>
571
571
<td><p><span class="term"><em class="parameter"><code>use_underline</code></em> :</span></p></td>
572
572
<td>
573
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics
 
573
<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
574
574
</td>
575
575
</tr>
576
576
</tbody>
580
580
<div class="refsect2" title="gtk_button_set_focus_on_click ()">
581
581
<a name="gtk-button-set-focus-on-click"></a><h3>gtk_button_set_focus_on_click ()</h3>
582
582
<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>,
583
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> focus_on_click</code></em>);</pre>
 
583
                                                         <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>
584
584
<p>
585
585
Sets whether the button will grab focus when it is clicked with the mouse.
586
586
Making mouse clicks not grab focus is useful in places like toolbars where
607
607
<hr>
608
608
<div class="refsect2" title="gtk_button_get_focus_on_click ()">
609
609
<a name="gtk-button-get-focus-on-click"></a><h3>gtk_button_get_focus_on_click ()</h3>
610
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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>
 
610
<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>
611
611
<p>
612
612
Returns whether the button grabs focus when it is clicked with the mouse.
613
613
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>.
622
622
</tr>
623
623
<tr>
624
624
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
625
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the button grabs focus when it is clicked with
 
625
<td> <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
626
626
              the mouse.
627
627
 
628
628
</td>
635
635
<div class="refsect2" title="gtk_button_set_alignment ()">
636
636
<a name="gtk-button-set-alignment"></a><h3>gtk_button_set_alignment ()</h3>
637
637
<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>,
638
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>,
639
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> yalign</code></em>);</pre>
 
638
                                                         <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>,
 
639
                                                         <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>
640
640
<p>
641
641
Sets the alignment of the child. This property has no effect unless 
642
642
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>.
669
669
<div class="refsect2" title="gtk_button_get_alignment ()">
670
670
<a name="gtk-button-get-alignment"></a><h3>gtk_button_get_alignment ()</h3>
671
671
<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>,
672
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *xalign</code></em>,
673
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *yalign</code></em>);</pre>
 
672
                                                         <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>,
 
673
                                                         <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>
674
674
<p>
675
675
Gets the alignment of the child in the button.
676
676
</p>
743
743
</tr>
744
744
<tr>
745
745
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
746
 
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case there is no image
 
746
<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
747
747
 
748
748
</td>
749
749
</tr>
808
808
<a name="GtkButton.property-details"></a><h2>Property Details</h2>
809
809
<div class="refsect2" title='The "focus-on-click" property'>
810
810
<a name="GtkButton--focus-on-click"></a><h3>The <code class="literal">"focus-on-click"</code> property</h3>
811
 
<pre class="programlisting">  "focus-on-click"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
811
<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
812
<p>Whether the button grabs focus when it is clicked with the mouse.</p>
813
813
<p>Default value: TRUE</p>
814
814
</div>
831
831
<hr>
832
832
<div class="refsect2" title='The "label" property'>
833
833
<a name="GtkButton--label"></a><h3>The <code class="literal">"label"</code> property</h3>
834
 
<pre class="programlisting">  "label"                    <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct</pre>
 
834
<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
835
<p>Text of the label widget inside the button, if the button contains a label widget.</p>
836
836
<p>Default value: NULL</p>
837
837
</div>
845
845
<hr>
846
846
<div class="refsect2" title='The "use-stock" property'>
847
847
<a name="GtkButton--use-stock"></a><h3>The <code class="literal">"use-stock"</code> property</h3>
848
 
<pre class="programlisting">  "use-stock"                <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
 
848
<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
849
<p>If set, the label is used to pick a stock item instead of being displayed.</p>
850
850
<p>Default value: FALSE</p>
851
851
</div>
852
852
<hr>
853
853
<div class="refsect2" title='The "use-underline" property'>
854
854
<a name="GtkButton--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3>
855
 
<pre class="programlisting">  "use-underline"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
 
855
<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
856
<p>If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key.</p>
857
857
<p>Default value: FALSE</p>
858
858
</div>
859
859
<hr>
860
860
<div class="refsect2" title='The "xalign" property'>
861
861
<a name="GtkButton--xalign"></a><h3>The <code class="literal">"xalign"</code> property</h3>
862
 
<pre class="programlisting">  "xalign"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
 
862
<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
863
<p>
864
864
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
865
865
can be used to control it's horizontal alignment. 0.0 is left aligned, 
872
872
<hr>
873
873
<div class="refsect2" title='The "yalign" property'>
874
874
<a name="GtkButton--yalign"></a><h3>The <code class="literal">"yalign"</code> property</h3>
875
 
<pre class="programlisting">  "yalign"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
 
875
<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
876
<p>
877
877
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 
878
878
can be used to control it's vertical alignment. 0.0 is top aligned, 
887
887
<a name="GtkButton.style-property-details"></a><h2>Style Property Details</h2>
888
888
<div class="refsect2" title='The "child-displacement-x" style property'>
889
889
<a name="GtkButton--s-child-displacement-x"></a><h3>The <code class="literal">"child-displacement-x"</code> style property</h3>
890
 
<pre class="programlisting">  "child-displacement-x"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
890
<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
891
<p>How far in the x direction to move the child when the button is depressed.</p>
892
892
<p>Default value: 0</p>
893
893
</div>
894
894
<hr>
895
895
<div class="refsect2" title='The "child-displacement-y" style property'>
896
896
<a name="GtkButton--s-child-displacement-y"></a><h3>The <code class="literal">"child-displacement-y"</code> style property</h3>
897
 
<pre class="programlisting">  "child-displacement-y"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
897
<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
898
<p>How far in the y direction to move the child when the button is depressed.</p>
899
899
<p>Default value: 0</p>
900
900
</div>
922
922
<hr>
923
923
<div class="refsect2" title='The "displace-focus" style property'>
924
924
<a name="GtkButton--s-displace-focus"></a><h3>The <code class="literal">"displace-focus"</code> style property</h3>
925
 
<pre class="programlisting">  "displace-focus"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 
925
<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
926
<p>
927
927
Whether the child_displacement_x/child_displacement_y properties
928
928
should also affect the focus rectangle.
933
933
<hr>
934
934
<div class="refsect2" title='The "image-spacing" style property'>
935
935
<a name="GtkButton--s-image-spacing"></a><h3>The <code class="literal">"image-spacing"</code> style property</h3>
936
 
<pre class="programlisting">  "image-spacing"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
936
<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
937
<p>Spacing in pixels between the image and label.</p>
938
938
<p>Allowed values: &gt;= 0</p>
939
939
<p>Default value: 2</p>
953
953
<div class="refsect2" title='The "activate" signal'>
954
954
<a name="GtkButton-activate"></a><h3>The <code class="literal">"activate"</code> signal</h3>
955
955
<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,
956
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First / Action</pre>
 
956
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First / Action</pre>
957
957
<p>
958
958
The ::activate signal on GtkButton is an action signal and
959
959
emitting it causes the button to animate press then release.
979
979
<div class="refsect2" title='The "clicked" signal'>
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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First / Action</pre>
 
982
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First / Action</pre>
983
983
<p>
984
984
Emitted when the button has been activated (pressed and released).
985
985
</p>
1002
1002
<div class="refsect2" title='The "enter" signal'>
1003
1003
<a name="GtkButton-enter"></a><h3>The <code class="literal">"enter"</code> signal</h3>
1004
1004
<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,
1005
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
 
1005
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
1006
1006
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1007
1007
<h3 class="title">Warning</h3>
1008
1008
<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>
1029
1029
<div class="refsect2" title='The "leave" signal'>
1030
1030
<a name="GtkButton-leave"></a><h3>The <code class="literal">"leave"</code> signal</h3>
1031
1031
<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,
1032
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
 
1032
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
1033
1033
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1034
1034
<h3 class="title">Warning</h3>
1035
1035
<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>
1056
1056
<div class="refsect2" title='The "pressed" signal'>
1057
1057
<a name="GtkButton-pressed"></a><h3>The <code class="literal">"pressed"</code> signal</h3>
1058
1058
<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,
1059
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
 
1059
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
1060
1060
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1061
1061
<h3 class="title">Warning</h3>
1062
1062
<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>
1083
1083
<div class="refsect2" title='The "released" signal'>
1084
1084
<a name="GtkButton-released"></a><h3>The <code class="literal">"released"</code> signal</h3>
1085
1085
<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,
1086
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
 
1086
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : Run First</pre>
1087
1087
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1088
1088
<h3 class="title">Warning</h3>
1089
1089
<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>