Description
GtkToolButtons are GtkToolItems containing buttons.
Use gtk_tool_button_new() to create a new GtkToolButton.
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.
CSS nodes
GtkToolButton has a single CSS node with name toolbutton.
Functions
gtk_tool_button_new ()
GtkToolItem *
gtk_tool_button_new (GtkWidget *icon_widget,
const gchar *label);
Creates a new GtkToolButton using icon_widget
as contents and label
as
label.
Since: 2.4
gtk_tool_button_new_from_stock ()
GtkToolItem *
gtk_tool_button_new_from_stock (const gchar *stock_id);
Creates a new GtkToolButton containing the image and text from a
stock item. Some stock ids have preprocessor macros like GTK_STOCK_OK
and GTK_STOCK_APPLY.
It is an error if stock_id
is not a name of a stock item.
Since: 2.4
gtk_tool_button_get_label ()
const gchar *
gtk_tool_button_get_label (GtkToolButton *button);
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.
Returns
The label, or NULL.
[nullable]
Since: 2.4
gtk_tool_button_set_use_underline ()
void
gtk_tool_button_set_use_underline (GtkToolButton *button,
gboolean 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.
Since: 2.4
gtk_tool_button_get_use_underline ()
gboolean
gtk_tool_button_get_use_underline (GtkToolButton *button);
Returns whether underscores in the label property are used as mnemonics
on menu items on the overflow menu. See gtk_tool_button_set_use_underline().
Returns
TRUE if underscores in the label property are used as
mnemonics on menu items on the overflow menu.
Since: 2.4
gtk_tool_button_get_stock_id ()
const gchar *
gtk_tool_button_get_stock_id (GtkToolButton *button);
gtk_tool_button_get_stock_id has been deprecated since version 3.10 and should not be used in newly-written code.
Use gtk_tool_button_get_icon_name() instead.
Returns the name of the stock item. See gtk_tool_button_set_stock_id().
The returned string is owned by GTK+ and must not be freed or modifed.
Returns
the name of the stock item for button
.
Since: 2.4
gtk_tool_button_get_icon_name ()
const gchar *
gtk_tool_button_get_icon_name (GtkToolButton *button);
Returns the name of the themed icon for the tool button,
see gtk_tool_button_set_icon_name().
Returns
the icon name or NULL if the tool button has
no themed icon.
[nullable]
Since: 2.8
gtk_tool_button_set_icon_widget ()
void
gtk_tool_button_set_icon_widget (GtkToolButton *button,
GtkWidget *icon_widget);
Sets icon
as the widget used as icon on button
. If icon_widget
is
NULL the icon is determined by the “stock-id” property. If the
“stock-id” property is also NULL, button
will not have an icon.
Since: 2.4
gtk_tool_button_set_label_widget ()
void
gtk_tool_button_set_label_widget (GtkToolButton *button,
GtkWidget *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.
Since: 2.4
Property Details
The “icon-name” property
“icon-name” gchar *
The name of the themed icon displayed on the item.
This property only has an effect if not overridden by
“label-widget”, “icon-widget” or
“stock-id” properties.
Owner: GtkToolButton
Flags: Read / Write
Default value: NULL
Since: 2.8
The “icon-widget” property
“icon-widget” GtkWidget *
Icon widget to display in the item.
Owner: GtkToolButton
Flags: Read / Write
The “label” property
“label” gchar *
Text to show in the item.
Owner: GtkToolButton
Flags: Read / Write
Default value: NULL
The “label-widget” property
“label-widget” GtkWidget *
Widget to use as the item label.
Owner: GtkToolButton
Flags: Read / Write
The “stock-id” property
“stock-id” gchar *
The stock icon displayed on the item.
GtkToolButton:stock-id has been deprecated since version 3.10 and should not be used in newly-written code.
Use “icon-name” instead.
Owner: GtkToolButton
Flags: Read / Write
Default value: NULL
The “use-underline” property
“use-underline” gboolean
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.
Owner: GtkToolButton
Flags: Read / Write
Default value: FALSE