<!-- ##### SECTION Title ##### -->GtkButton<!-- ##### SECTION Short_Description ##### -->A widget that creates a signal when clicked on<!-- ##### SECTION Long_Description ##### --><para>The #GtkButton widget is generally used to attach a function to thatis called when the button is pressed.  The various signals and how to usethem are outlined below.</para><para>The #GtkButton widget can hold any valid child widget.  That is it canhold most any other standard #GtkWidget.  The most commonly used child isthe #GtkLabel.</para><!-- ##### SECTION See_Also ##### --><para></para><!-- ##### SECTION Stability_Level ##### --><!-- ##### STRUCT GtkButton ##### --><para>This should not be accessed directly.  Use the accessor functions below.</para><!-- ##### SIGNAL GtkButton::activate ##### --><para></para>@button: the object which received the signal.<!-- ##### SIGNAL GtkButton::clicked ##### --><para>Emitted when a button clicked on by the mouse and the cursor stays on thebutton.  If the cursor is not on the button when the mouse button is released,the signal is not emitted.</para>@button: the object which received the signal.<!-- ##### SIGNAL GtkButton::enter ##### --><para>Emitted when the mouse cursor enters the region of the button.</para>@button: the object which received the signal.<!-- ##### SIGNAL GtkButton::leave ##### --><para>Emitted when the mouse cursor leaves the region of the button.</para>@button: the object which received the signal.<!-- ##### SIGNAL GtkButton::pressed ##### --><para>Emitted when the button is initially pressed.</para>@button: the object which received the signal.<!-- ##### SIGNAL GtkButton::released ##### --><para>Emitted when a button which is pressed is released, no matter where themouse cursor is.</para>@button: the object which received the signal.<!-- ##### ARG GtkButton:focus-on-click ##### --><para></para><!-- ##### ARG GtkButton:image ##### --><para></para><!-- ##### ARG GtkButton:label ##### --><para></para><!-- ##### ARG GtkButton:relief ##### --><para></para><!-- ##### ARG GtkButton:use-stock ##### --><para></para><!-- ##### ARG GtkButton:use-underline ##### --><para></para><!-- ##### ARG GtkButton:xalign ##### --><para></para><!-- ##### ARG GtkButton:yalign ##### --><para></para><!-- ##### ARG GtkButton:child-displacement-x ##### --><para></para><!-- ##### ARG GtkButton:child-displacement-y ##### --><para></para><!-- ##### ARG GtkButton:default-border ##### --><para></para><!-- ##### ARG GtkButton:default-outside-border ##### --><para></para><!-- ##### ARG GtkButton:displace-focus ##### --><para></para><!-- ##### FUNCTION gtk_button_new ##### --><para>Creates a new #GtkButton widget. To add a child widget to the button,use gtk_container_add().</para>@Returns: The newly created #GtkButton widget.<!-- ##### FUNCTION gtk_button_new_with_label ##### --><para>Creates a #GtkButton widget with a #GtkLabel child containing the giventext.</para>@label: The text you want the #GtkLabel to hold.@Returns: The newly created #GtkButton widget.<!-- ##### FUNCTION gtk_button_new_with_mnemonic ##### --><para></para>@label: @Returns: <!-- ##### FUNCTION gtk_button_new_from_stock ##### --><para></para>@stock_id: @Returns: <!-- ##### FUNCTION gtk_button_pressed ##### --><para>Emits a #GtkButton::pressed signal to the given #GtkButton.</para>@button: The #GtkButton you want to send the signal to.<!-- ##### FUNCTION gtk_button_released ##### --><para>Emits a #GtkButton::released signal to the given #GtkButton.</para>@button: The #GtkButton you want to send the signal to.<!-- ##### FUNCTION gtk_button_clicked ##### --><para>Emits a #GtkButton::clicked signal to the given #GtkButton.</para>@button: The #GtkButton you want to send the signal to.<!-- ##### FUNCTION gtk_button_enter ##### --><para>Emits a #GtkButton::enter signal to the given #GtkButton.</para>@button: The #GtkButton you want to send the signal to.<!-- ##### FUNCTION gtk_button_leave ##### --><para>Emits a #GtkButton::leave signal to the given #GtkButton.</para>@button: The #GtkButton you want to send the signal to.<!-- ##### FUNCTION gtk_button_set_relief ##### --><para>Sets the relief style of the edges of the given #GtkButton widget.Three styles exist, GTK_RELIEF_NORMAL, GTK_RELIEF_HALF, GTK_RELIEF_NONE.The default style is, as one can guess, GTK_RELIEF_NORMAL.<!-- FIXME: put pictures of each style --></para>@button: The #GtkButton you want to set relief styles of.@newstyle: The GtkReliefStyle as described above.<!-- ##### FUNCTION gtk_button_get_relief ##### --><para>Returns the current relief style of the given #GtkButton.</para>@button: The #GtkButton you want the #GtkReliefStyle from.@Returns: The current #GtkReliefStyle<!-- ##### FUNCTION gtk_button_get_label ##### --><para></para>@button: @Returns: <!-- ##### FUNCTION gtk_button_set_label ##### --><para></para>@button: @label: <!-- ##### FUNCTION gtk_button_get_use_stock ##### --><para></para>@button: @Returns: <!-- ##### FUNCTION gtk_button_set_use_stock ##### --><para></para>@button: @use_stock: <!-- # Unused Parameters # -->@value: <!-- ##### FUNCTION gtk_button_get_use_underline ##### --><para></para>@button: @Returns: <!-- ##### FUNCTION gtk_button_set_use_underline ##### --><para></para>@button: @use_underline: <!-- # Unused Parameters # -->@value: <!-- ##### FUNCTION gtk_button_set_focus_on_click ##### --><para></para>@button: @focus_on_click: <!-- ##### FUNCTION gtk_button_get_focus_on_click ##### --><para></para>@button: @Returns: <!-- ##### FUNCTION gtk_button_set_alignment ##### --><para></para>@button: @xalign: @yalign: <!-- ##### FUNCTION gtk_button_get_alignment ##### --><para></para>@button: @xalign: @yalign: <!-- ##### FUNCTION gtk_button_set_image ##### --><para></para>@button: @image: <!-- ##### FUNCTION gtk_button_get_image ##### --><para></para>@button: @Returns: