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
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.
Warning: stock-id has been deprecated since version 3.10 and should not be used in newly-written code. Use icon-name instead.
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.

CSS nodes

The gtk-tool-button class has a single CSS node with name toolbutton.

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