Gtk2::Button(3)

NAME
Gtk2::Button

HIERARCHY
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gtk2::Button

INTERFACES
  Glib::Object::_Unregistered::AtkImplementorIface
  Gtk2::Buildable
  Gtk2::Activatable

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. "Gtk2::Button::new_with_label").

METHODS

  widget = Gtk2::Button->new

  widget = Gtk2::Button->new ($mnemonic)

•   $mnemonic (string) used to label the widget, see "MNEMONICS"

  widget = Gtk2::Button->new_from_stock ($stock_id)

•   $stock_id (string) creates a new button using the icon and text from the

specified stock item, see Gtk2::Stock

  widget = Gtk2::Button->new_with_label ($label)

•   $label (string) used to label the widget

  widget = Gtk2::Button->new_with_mnemonic ($mnemonic)

•   $mnemonic (string) used to label the widget, see "MNEMONICS"

  (xalign, yalign) = $button->get_alignment
Since: gtk+ 2.4

  $button->set_alignment ($xalign, $yalign)

•   $xalign (double)

•   $yalign (double)

Since: gtk+ 2.4

  $button->clicked

  $button->enter

  window or undef = $button->get_event_window
Since: gtk+ 2.22

  boolean = $button->get_focus_on_click
Since: gtk+ 2.4

  $button->set_focus_on_click ($focus_on_click)

•   $focus_on_click (boolean)

Since: gtk+ 2.4

  widget or undef = $button->get_image
Since: gtk+ 2.6

  positiontype = $button->get_image_position
Since: gtk+ 2.10

  $button->set_image_position ($position)

•   $position (Gtk2::PositionType)

Since: gtk+ 2.10

  $button->set_image ($image)

•   $image (Gtk2::Widget or undef)

Since: gtk+ 2.6

  string = $button->get_label

  $button->set_label ($label)

•   $label (string)

  $button->leave

  $button->pressed

  $button->released

  reliefstyle = $button->get_relief

  $button->set_relief ($newstyle)

•   $newstyle (Gtk2::ReliefStyle)

  boolean = $button->get_use_stock

  $button->set_use_stock ($use_stock)

•   $use_stock (boolean)

  boolean = $button->get_use_underline

  $button->set_use_underline ($use_underline)

•   $use_underline (boolean)

PROPERTIES

'focus-on-click' (boolean : default true : readable / writable / private)
    Whether the button grabs focus when it is clicked with the mouse

'image' (Gtk2::Widget : default undef : readable / writable / private)
    Child widget to appear next to the button text

'image-position' (Gtk2::PositionType : default "left" : readable / writable / private)
    The position of the image relative to the text

'label' (string : default undef : readable / writable / construct / private)
    Text of the label widget inside the button, if the button contains a label widget

'relief' (Gtk2::ReliefStyle : default "normal" : readable / writable / private)
    The border relief style

'use-stock' (boolean : default false : readable / writable / construct / private)
    If set, the label is used to pick a stock item instead of being displayed

'use-underline' (boolean : default false : readable / writable / construct / private)
    If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key

'xalign' (float : default 0.5 : readable / writable / private)
    Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned

'yalign' (float : default 0.5 : readable / writable / private)
    Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned

STYLE PROPERTIES

'child-displacement-x' (integer : default 0 : readable / private)
    How far in the x direction to move the child when the button is depressed

'child-displacement-y' (integer : default 0 : readable / private)
    How far in the y direction to move the child when the button is depressed

'default-border' (Gtk2::Border : default undef : readable / private)
    Extra space to add for GTK_CAN_DEFAULT buttons

'default-outside-border' (Gtk2::Border : default undef : readable / private)
    Extra space to add for GTK_CAN_DEFAULT buttons that is always drawn outside the border

'displace-focus' (boolean : default false : readable / private)
    Whether the child_displacement_x/_y properties should also affect the focus rectangle

'image-spacing' (integer : default 2 : readable / private)
    Spacing in pixels between the image and label

'inner-border' (Gtk2::Border : default undef : readable / private)
    Border between button edges and child.

SIGNALS

pressed (Gtk2::Button)
released (Gtk2::Button)
clicked (Gtk2::Button)
enter (Gtk2::Button)
leave (Gtk2::Button)
activate (Gtk2::Button)

ENUMS AND FLAGS

  enum Gtk2::PositionType

•   'left' / 'GTK_POS_LEFT'

•   'right' / 'GTK_POS_RIGHT'

•   'top' / 'GTK_POS_TOP'

•   'bottom' / 'GTK_POS_BOTTOM'

  enum Gtk2::ReliefStyle

•   'normal' / 'GTK_RELIEF_NORMAL'

•   'half' / 'GTK_RELIEF_HALF'

•   'none' / 'GTK_RELIEF_NONE'

SEE ALSO
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin

COPYRIGHT
Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.