Forum und email
GTK Classes
Prev GtkToolButton Next

GtkToolButton

A GtkToolItem that displays a button.

Object Hierarchy

GObject
`-- GtkObject
       `-- GtkWidget
              `-- GtkContainer
                     `-- GtkBin
                            `-- GtkToolItem
                                   `-- GtkToolButton

Direct Subclasses

GtkMenuToolButton, GtkToggleToolButton

Description

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.

Constructors

GtkToolButton ([GtkWidget icon_widget = null [, string label = null]]);

-- Creates a new tool button.

-- Creates a new tool button based on a stock item.

Methods

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.

Properties

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.

Signals

"clicked"
  The button has been clicked

Prev Home Next
GtkToolbar::toolbar-style Up GtkToolButton Constructor