Package: gtk

Class gtk-tool-button

Superclasses

Documented Subclasses

Direct Slots

icon-name
The "icon-name" property of type :string (Read / Write)
The name of the themed icon displayed on the item. This property only has an effect if not overridden by "label", "icon-widget" or "stock-id" properties.
Default value: nil Since 2.8
icon-widget
The "icon-widget" property of type gtk-widget (Read / Write)
Icon widget to display in the item.
label
The "label" property of type :string (Read / Write)
Text to show in the item.
Default value: nil
label-widget
The "label-widget" property of type gtk-widget (Read / Write)
Widget to use as the item label.
stock-id
The "stock-id" property of type :string (Read / Write)
The stock icon displayed on the item.
Default value: nil
use-underline
The "use-underline" property of type :boolean (Read / Write)
If set, an underline in the label property indicates that the next character should be used for the mnemonic accelerator key in the overflow menu.
Default value: nil

Details

gtk-tool-button's are gtk-tool-item's containing buttons.

Use the function gtk-tool-button-new to create a new gtk-tool-button. Use the function gtk-tool-button-new-from-stock to create a gtk-tool-button containing a stock item.

The label of a gtk-tool-button is determined by the properties "label-widget", "label", and "stock-id". If "label-widget" is non-nil, then that widget is used as the label. Otherwise, if "label" is non-nil, that string is used as the label. Otherwise, if "stock-id" is non-nil, the label is determined by the stock item. Otherwise, the button does not have a label.

The icon of a gtk-tool-button is determined by the properties "icon-widget" and "stock-id". If "icon-widget" is non-nil, then that widget is used as the icon. Otherwise, if "stock-id" is non-nil, the icon is determined by the stock item. Otherwise, the button does not have a icon.

Style Property Details

The "icon-spacing" style property
"icon-spacing" of type :int (Read / Write)
Spacing in pixels between the icon and label.
Allowed values: >= 0
Default value: 3

Signal Details

The "clicked" signal
 lambda (toolbutton)   : Action      
This signal is emitted when the tool button is clicked with the mouse or activated with the keyboard.
toolbutton
The object that emitted the signal.
 

Slot Access Functions

Inherited Slot Access Functions

2014-1-26