|
|
|
GTK+ 2 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> struct 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
GtkMenuToolButton implements AtkImplementorIface, GtkBuildable and GtkActivatable.
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.
The GtkMenuToolButton implementation of the GtkBuildable interface supports adding a menu by specifying "menu" as the "type" attribute of a <child> element.
Example 35. A UI definition fragment with menus
1 2 3 4 5 |
<object class="GtkMenuToolButton"> <child type="menu"> <object class="GtkMenu"/> </child> </object> |
struct 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. [allow-none]
|
|
a string that will be used as label, or NULL. [allow-none]
|
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. [transfer none] |
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. [allow-none] |
|
text to be used as private tooltip text. [allow-none] |
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 *button,
gpointer user_data) : Run First
The ::show-menu signal is emitted before the menu is shown.
It can be used to populate the menu on demand, using
gtk_menu_tool_button_get_menu().
Note that even if you populate the menu dynamically in this way, you must set an empty menu on the GtkMenuToolButton beforehand, since the arrow is made insensitive if the menu is not set.
|
the object on which the signal is emitted |
|
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. |