The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
/*
 * Copyright (c) 2003-2006 by the gtk2-perl team (see the file AUTHORS)
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the 
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, 
 * Boston, MA  02111-1307  USA.
 *
 * $Id$
 */

#include "gtk2perl.h"

MODULE = Gtk2::Button	PACKAGE = Gtk2::Button	PREFIX = gtk_button_

=head1 MNEMONICS

Mnemonics are "memory aids"; in GTK+, a mnemonic is an underlined character
which corresponds to a keyboard accelerator.  For a button, that means pressing
Alt and that key activates the button.

For convenience, Gtk2-Perl uses mnemonics by default on widgets that support
them.  If characters in label string are preceded by an underscore, they are
underlined.  If you need a literal underscore character in a label, use '__'
(two underscores).  If you don't want to use mnemonics at all, use the
non-mnemonic version explicitly (e.g. C<Gtk2::Button::new_with_label>).

=cut

=for apidoc Gtk2::Button::new 
=for signature widget = Gtk2::Button->new
=for signature widget = Gtk2::Button->new ($mnemonic)
=for arg label (__hide__)
=for arg mnemonic (string) used to label the widget, see L</MNEMONICS>
=cut

=for apidoc Gtk2::Button::new_with_mnemonic
=for signature widget = Gtk2::Button->new_with_mnemonic ($mnemonic)
=for arg label (__hide__)
=for arg mnemonic (string) used to label the widget, see L</MNEMONICS>
=cut

=for apidoc Gtk2::Button::new_with_label
=for signature widget = Gtk2::Button->new_with_label ($label)
=for arg label (string) used to label the widget
=cut

GtkWidget *
gtk_button_new (class, label=NULL)
	const gchar * label
    ALIAS:
	Gtk2::Button::new_with_mnemonic = 1
	Gtk2::Button::new_with_label = 2
    CODE:
	if (label) {
		if (ix == 2)
			RETVAL = gtk_button_new_with_label (label);
		else
			RETVAL = gtk_button_new_with_mnemonic (label);
	} else
		RETVAL = gtk_button_new ();
    OUTPUT:
	RETVAL

# TODO: find and/or create Gtk2::StockItems info/page
=for apidoc

=for arg stock_id (string) creates a new button using the icon and text from the
specified stock item, see L<Gtk2::Stock>

=cut
GtkWidget *
gtk_button_new_from_stock (class, stock_id)
	const gchar * stock_id
    C_ARGS:
	stock_id

void
gtk_button_pressed (button)
	GtkButton * button

void
gtk_button_released (button)
	GtkButton * button

void
gtk_button_clicked (button)
	GtkButton * button

void
gtk_button_enter (button)
	GtkButton * button

void
gtk_button_leave (button)
	GtkButton * button

void
gtk_button_set_relief (button, newstyle)
	GtkButton * button
	GtkReliefStyle  newstyle

GtkReliefStyle
gtk_button_get_relief (button)
	GtkButton * button


void
gtk_button_set_label (button, label)
	GtkButton * button
	const gchar * label

# had G_CONST_RETURN
const gchar *
gtk_button_get_label (button)
	GtkButton * button

void
gtk_button_set_use_underline (button, use_underline)
	GtkButton * button
	gboolean     use_underline

gboolean
gtk_button_get_use_underline (button)
	GtkButton * button

void
gtk_button_set_use_stock (button, use_stock)
	GtkButton * button
	gboolean     use_stock

gboolean
gtk_button_get_use_stock (button)
	GtkButton * button

#if GTK_CHECK_VERSION(2,4,0)

void gtk_button_set_focus_on_click (GtkButton * button, gboolean focus_on_click)

gboolean gtk_button_get_focus_on_click (GtkButton * button)

void gtk_button_set_alignment (GtkButton * button, gfloat xalign, gfloat yalign)

 ## void gtk_button_get_alignment (GtkButton *button, gfloat *xalign, gfloat *yalign)
void gtk_button_get_alignment (GtkButton *button, OUTLIST gfloat xalign, OUTLIST gfloat yalign)

#endif

#if GTK_CHECK_VERSION(2,6,0)

void gtk_button_set_image (GtkButton *button, GtkWidget_ornull *image)

GtkWidget_ornull * gtk_button_get_image (GtkButton *button)

#endif

#if GTK_CHECK_VERSION(2,10,0)

void gtk_button_set_image_position (GtkButton *button, GtkPositionType position);

GtkPositionType gtk_button_get_image_position (GtkButton *button);

#endif

#if GTK_CHECK_VERSION (2, 22, 0)

GdkWindow_ornull * gtk_button_get_event_window (GtkButton *button);

#endif /* 2.22 */