NAME

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

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

PROPERTIES

'focus-on-click' (boolean : default true : readable / writable / private / static-nick / static-blurb)

Whether the button grabs focus when it is clicked with the mouse

'image' (Gtk2::Widget : default undef : readable / writable / private / static-nick / static-blurb)

Child widget to appear next to the button text

'image-position' (Gtk2::PositionType : default "left" : readable / writable / private / static-nick / static-blurb)

The position of the image relative to the text

'label' (string : default undef : readable / writable / construct / private / static-nick / static-blurb)

Text of the label widget inside the button, if the button contains a label widget

'relief' (Gtk2::ReliefStyle : default "normal" : readable / writable / private / static-nick / static-blurb)

The border relief style

'use-stock' (boolean : default false : readable / writable / construct / private / static-nick / static-blurb)

If set, the label is used to pick a stock item instead of being displayed

'use-underline' (boolean : default false : readable / writable / construct / private / static-nick / static-blurb)

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 / static-nick / static-blurb)

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 / static-nick / static-blurb)

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 / static-nick / static-blurb)

How far in the x direction to move the child when the button is depressed

'child-displacement-y' (integer : default 0 : readable / private / static-nick / static-blurb)

How far in the y direction to move the child when the button is depressed

'default-border' (Gtk2::Border : default undef : readable / private / static-nick / static-blurb)

Extra space to add for GTK_CAN_DEFAULT buttons

'default-outside-border' (Gtk2::Border : default undef : readable / private / static-nick / static-blurb)

Extra space to add for GTK_CAN_DEFAULT buttons that is always drawn outside the border

'displace-focus' (boolean : default false : readable / private / static-nick / static-blurb)

Whether the child_displacement_x/_y properties should also affect the focus rectangle

'image-spacing' (integer : default 2 : readable / private / static-nick / static-blurb)

Spacing in pixels between the image and label

'inner-border' (Gtk2::Border : default undef : readable / private / static-nick / static-blurb)

Border between button edges and child.

SIGNALS

activate (Gtk2::Button)

clicked (Gtk2::Button)

enter (Gtk2::Button)

leave (Gtk2::Button)

pressed (Gtk2::Button)

released (Gtk2::Button)

ENUMS AND FLAGS

SEE ALSO

COPYRIGHT

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