Top | ![]() |
![]() |
![]() |
![]() |
GtkToolItem * | gtk_tool_button_new () |
void | gtk_tool_button_set_label () |
const gchar * | gtk_tool_button_get_label () |
void | gtk_tool_button_set_use_underline () |
gboolean | gtk_tool_button_get_use_underline () |
void | gtk_tool_button_set_icon_name () |
const gchar * | gtk_tool_button_get_icon_name () |
void | gtk_tool_button_set_icon_widget () |
GtkWidget * | gtk_tool_button_get_icon_widget () |
void | gtk_tool_button_set_label_widget () |
GtkWidget * | gtk_tool_button_get_label_widget () |
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” and “label”.
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.
The icon of a GtkToolButton is determined by the
“icon-widget” property. If
“icon-widget” is non-NULL
, then
that widget is used as the icon. Otherwise it does not have an icon.
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
void gtk_tool_button_set_label (GtkToolButton *button
,const gchar *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
, button
will not have a label.
Since: 2.4
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. The returned
string is owned by GTK+, and must not be modified or freed.
Since: 2.4
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
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()
.
TRUE
if underscores in the label property are used as
mnemonics on menu items on the overflow menu.
Since: 2.4
void gtk_tool_button_set_icon_name (GtkToolButton *button
,const gchar *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-widget” or
“icon-widget” properties.
Since: 2.8
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()
.
Since: 2.8
void gtk_tool_button_set_icon_widget (GtkToolButton *button
,GtkWidget *icon_widget
);
Sets icon
as the widget used as icon on button
.
Since: 2.4
GtkWidget *
gtk_tool_button_get_icon_widget (GtkToolButton *button
);
Return the widget used as icon widget on button
.
See gtk_tool_button_set_icon_widget()
.
Since: 2.4
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
, button
does not have a label.
Since: 2.4
GtkWidget *
gtk_tool_button_get_label_widget (GtkToolButton *button
);
Returns the widget used as label on button
.
See gtk_tool_button_set_label_widget()
.
Since: 2.4
struct GtkToolButtonClass { GtkToolItemClass parent_class; GType button_type; /* signal */ void (* clicked) (GtkToolButton *tool_item); };
GType |
||
Signal emitted when the tool button is clicked with the mouse or activated with the keyboard. |