/*
* Copyright (c) 2003 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.
*
* $Header: /cvsroot/gtk2-perl/gtk2-perl-xs/Gtk2/xs/GtkButton.xs,v 1.15.2.1 2004/03/17 02:47:14 muppetman Exp $
*/
#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)
##void gtk_button_get_alignment (GtkButton *button)
## PREINIT:
## gfloat xalign;
## gfloat yalign;
## PPCODE:
## gtk_button_get_alignment (button, &xalign, &yalign);
## warn ("%.20f, %.20f", xalign, yalign);
## EXTEND (sp, 2);
## PUSHs (sv_2mortal (newSVnv (xalign)));
## PUSHs (sv_2mortal (newSVnv (yalign)));
#endif