Description

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 icon.

Details

GtkToolButton

typedef struct _GtkToolButton GtkToolButton;

The GtkToolButton struct contains only private. It should only be
accessed with the function described below.

gtk_tool_button_set_label ()

Sets label as the label used for the tool button. The "label" property
only has an effect if not overridden by a non-NULL "label_widget" property.
If both the "label_widget" and "label" properties are NULL, the label
is determined by the "stock_id" property. If the "stock_id" property is also
NULL, button will not have a label.

gtk_tool_button_get_label ()

Returns the label used by the tool button, or NULL if the tool button
doesn't have a label. or uses a the label from a stock item. The returned
string is owned by GTK+, and must not be modified or freed.

gtk_tool_button_set_use_underline ()

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. For
example, if the label property is "_Open" and use_underline is TRUE,
the label on the tool button will be "Open" and the item on the overflow
menu will have an underlined 'O'.

Labels shown on tool buttons never have mnemonics on them; this property
only affects the menu item on the overflow menu.

gtk_tool_button_set_icon_name ()

Sets the icon for the tool button from a named themed icon.
See the docs for GtkIconTheme for more details.
The "icon_name" property only has an effect if not
overridden by non-NULL "label", "icon_widget" and "stock_id"
properties.

gtk_tool_button_set_label_widget ()

Sets label_widget as the widget that will be used as the label
for button. If label_widget is NULL the "label" property is used
as label. If "label" is also NULL, the label in the stock item
determined by the "stock_id" property is used as label. If
"stock_id" is also NULL, button does not have a label.