GtkMenuToolButton as GtkBuildable

The GtkMenuToolButton implementation of the GtkBuildable interface supports adding a menu by specifying “menu” as the “type” attribute of a <child> element.

An example for a UI definition fragment with menus:

1
2
3
4
5

<object class="GtkMenuToolButton">
  <child type="menu">
    <object class="GtkMenu"/>
  </child>
</object>

gtk_menu_tool_button_new ()

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.

Since 2.6

gtk_menu_tool_button_new_from_stock ()

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 .

Since 2.6

gtk_menu_tool_button_set_menu ()

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.

Since 2.6

gtk_menu_tool_button_get_menu ()

GtkWidget *
gtk_menu_tool_button_get_menu (GtkMenuToolButton *button);

Gets the GtkMenu associated with GtkMenuToolButton.

Since 2.6

gtk_menu_tool_button_set_arrow_tooltip_text ()

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_text() for setting a tooltip on the whole GtkMenuToolButton.

Since 2.12

gtk_menu_tool_button_set_arrow_tooltip_markup ()

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_text() for setting a tooltip on the whole GtkMenuToolButton.

Since 2.12

struct GtkMenuToolButton

struct GtkMenuToolButton;

struct GtkMenuToolButtonClass

struct GtkMenuToolButtonClass {
  GtkToolButtonClass parent_class;


  void (*show_menu) (GtkMenuToolButton *button);
};

The “menu” property

  “menu”                     GtkMenu *

The dropdown menu.

Flags: Read / Write

The “show-menu” signal

void
user_function (GtkMenuToolButton *button,
               gpointer           user_data)

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

Flags: Run First