A GtkToolItem that displays a button.
GtkToolButtons are GtkToolItems containing buttons.
The label of a GtkToolButton is determined by the properties label_widget, label, and stock_id. If label_widget is non-NULL, then that widget is used as the label. Otherwise, if label is non-NULL, that string is used as the label. Otherwise, if stock_id is non-NULL, the label is determined by the stock item. Otherwise, the button does not have a label.
The icon of a GtkToolButton is determined by the properties icon_widget and stock_id. If icon_widget is non-NULL, then that widget is used as the icon. Otherwise, if stock_id is non-NULL, the icon is determined by the stock item. Otherwise, the button does not have a label.
-- Creates a new tool button.
-- Creates a new tool button based on a stock item.
get_icon_widget() Returns the icon widget used. get_label() Returns the buttons label. get_label_widget() Returns the label widget. get_stock_id() Returns the stock id. get_use_underline() If an underscore indicates the mnemonic. set_icon_widget() Sets the widget to be used as icon. set_label() Sets label as the label used for the tool button. set_label_widget() Sets the widget used as label. set_stock_id() Set the stock item. set_use_underline() Sets if an underscore is used as mnemonic indicator.
Use get_property and set_property methods to access these.
icon-widget: Icon widget to display in the item. label: Text to show in the item. label-widget: Widget to use as the item label. stock-id: The stock icon displayed on the item. use-underline: If an underscore indicates a mnemonic.
"clicked" The button has been clicked