GtkMenuToolButton

GtkMenuToolButton

Synopsis

#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_text
                                                        (GtkMenuToolButton *button,
                                                         const gchar *text);
void                gtk_menu_tool_button_set_arrow_tooltip_markup
                                                        (GtkMenuToolButton *button,
                                                         const gchar *markup);

Description

Details

GtkMenuToolButton

typedef struct {
  GtkToolButton parent;
} GtkMenuToolButton;


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.

icon_widget :

a widget that will be used as icon widget, or NULL. [allow-none]

label :

a string that will be used as label, or NULL. [allow-none]

Returns :

the new GtkMenuToolButton

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.

stock_id :

the name of a stock item

Returns :

the new GtkMenuToolButton

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.

button :

a GtkMenuToolButton

menu :

the GtkMenu associated with GtkMenuToolButton

Since 2.6


gtk_menu_tool_button_get_menu ()

GtkWidget *         gtk_menu_tool_button_get_menu       (GtkMenuToolButton *button);

Gets the GtkMenu associated with GtkMenuToolButton.

button :

a GtkMenuToolButton

Returns :

the GtkMenu associated with GtkMenuToolButton. [transfer none]

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.

button :

a GtkMenuToolButton

text :

text to be used as tooltip text for button's arrow button

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.

button :

a GtkMenuToolButton

markup :

markup text to be used as tooltip text for button's arrow button

Since 2.12