| GTK+ Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
GtkMenuToolButtonGtkMenuToolButton — A GtkToolItem containing a button with an additional dropdown menu |
#include <gtk/gtk.h>
GtkMenuToolButton;
GtkToolItem * gtk_menu_tool_button_new (GtkWidget *icon_widget,
const gchar *label);
GtkToolItem * gtk_menu_tool_button_new_from_stock (const gchar *stock_id);
void gtk_menu_tool_button_set_menu (GtkMenuToolButton *button,
GtkWidget *menu);
GtkWidget * gtk_menu_tool_button_get_menu (GtkMenuToolButton *button);
void gtk_menu_tool_button_set_arrow_tooltip
(GtkMenuToolButton *button,
GtkTooltips *tooltips,
const gchar *tip_text,
const gchar *tip_private);
void gtk_menu_tool_button_set_arrow_tooltip_text
(GtkMenuToolButton *button,
const gchar *text);
void gtk_menu_tool_button_set_arrow_tooltip_markup
(GtkMenuToolButton *button,
const gchar *markup);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkToolItem +----GtkToolButton +----GtkMenuToolButton
A GtkMenuToolButton is a GtkToolItem that contains a button and a small additional button with an arrow. When clicked, the arrow button pops up a dropdown menu.
Use gtk_menu_tool_button_new() to create a new
GtkMenuToolButton. Use gtk_menu_tool_button_new_from_stock() to
create a new GtkMenuToolButton containing a stock item.
typedef struct _GtkMenuToolButton GtkMenuToolButton;
The GtkMenuToolButton struct contains only private data and should only be accessed through the functions described below.
GtkToolItem * gtk_menu_tool_button_new (GtkWidget *icon_widget, const gchar *label);
Creates a new GtkMenuToolButton using icon_widget as icon and
label as label.
|
a widget that will be used as icon widget, or NULL
|
|
a string that will be used as label, or NULL
|
Returns : |
the new GtkMenuToolButton |
Since 2.6
GtkToolItem * gtk_menu_tool_button_new_from_stock (const gchar *stock_id);
Creates a new GtkMenuToolButton.
The new GtkMenuToolButton will contain an icon and label from
the stock item indicated by stock_id.
|
the name of a stock item |
Returns : |
the new GtkMenuToolButton |
Since 2.6
void gtk_menu_tool_button_set_menu (GtkMenuToolButton *button, GtkWidget *menu);
Sets the GtkMenu that is popped up when the user clicks on the arrow.
If menu is NULL, the arrow button becomes insensitive.
|
a GtkMenuToolButton |
|
the GtkMenu associated with GtkMenuToolButton |
Since 2.6
GtkWidget * gtk_menu_tool_button_get_menu (GtkMenuToolButton *button);
Gets the GtkMenu associated with GtkMenuToolButton.
|
a GtkMenuToolButton |
Returns : |
the GtkMenu associated with GtkMenuToolButton |
Since 2.6
void gtk_menu_tool_button_set_arrow_tooltip
(GtkMenuToolButton *button,
GtkTooltips *tooltips,
const gchar *tip_text,
const gchar *tip_private);
gtk_menu_tool_button_set_arrow_tooltip has been deprecated since version 2.12 and should not be used in newly-written code. Use gtk_menu_tool_button_set_arrow_tooltip_text()
instead.
Sets the GtkTooltips object to be used for arrow button which
pops up the menu. See gtk_tool_item_set_tooltip() for setting
a tooltip on the whole GtkMenuToolButton.
|
a GtkMenuToolButton |
|
the GtkTooltips object to be used |
|
text to be used as tooltip text for tool_item |
|
text to be used as private tooltip text |
Since 2.6
void gtk_menu_tool_button_set_arrow_tooltip_text
(GtkMenuToolButton *button,
const gchar *text);
Sets the tooltip text to be used as tooltip for the arrow button which
pops up the menu. See gtk_tool_item_set_tooltip() for setting a tooltip
on the whole GtkMenuToolButton.
|
a GtkMenuToolButton |
|
text to be used as tooltip text for button's arrow button |
Since 2.12
void gtk_menu_tool_button_set_arrow_tooltip_markup
(GtkMenuToolButton *button,
const gchar *markup);
Sets the tooltip markup text to be used as tooltip for the arrow button
which pops up the menu. See gtk_tool_item_set_tooltip() for setting a
tooltip on the whole GtkMenuToolButton.
|
a GtkMenuToolButton |
|
markup text to be used as tooltip text for button's arrow button |
Since 2.12
"show-menu" signalvoid user_function (GtkMenuToolButton *menutoolbutton, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
The toolbar widget
The parent class of GtkMenuToolButton. The properties "label_widget", "label", "icon_widget", and "stock_id" on GtkToolButton determine the label and icon used on GtkMenuToolButtons.