Gtk2::Button − wrapper for GtkButton
Glib::Object
+−−−−Glib::InitiallyUnowned
+−−−−Gtk2::Object
+−−−−Gtk2::Widget
+−−−−Gtk2::Container
+−−−−Gtk2::Bin
+−−−−Gtk2::Button
Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
Gtk2::Activatable
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").
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) |
’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
’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.
activate
(Gtk2::Button)
clicked (Gtk2::Button)
enter (Gtk2::Button)
leave (Gtk2::Button)
pressed (Gtk2::Button)
released (Gtk2::Button)
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 ’ |
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin
Copyright (C) 2003−2011 by the gtk2−perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.