MenuToolButton

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.

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.

Constructors

this
this(GtkMenuToolButton* gtkMenuToolButton)

Sets our main struct and passes it to the parent class

this
this(StockID stockId)

Creates a new GtkMenuToolButton. The new GtkMenuToolButton will contain an icon and label from the stock item indicated by stockID. Since 2.6

this
this(Widget iconWidget, string label)

Creates a new GtkMenuToolButton using icon_widget as icon and label as label. Since 2.6

this
this(string stockId)

Warning gtk_menu_tool_button_new_from_stock has been deprecated since version 3.10 and should not be used in newly-written code. Use gtk_menu_tool_button_new() instead. Creates a new GtkMenuToolButton. The new GtkMenuToolButton will contain an icon and label from the stock item indicated by stock_id. Since 2.6

Members

Functions

addOnShowMenu
void addOnShowMenu(void delegate(MenuToolButton) dlg, ConnectFlags connectFlags)

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. See Also GtkToolbar, GtkToolButton

getMenu
Menu getMenu()

Gets the GtkMenu associated with GtkMenuToolButton. Since 2.6

getMenuToolButtonStruct
GtkMenuToolButton* getMenuToolButtonStruct()
Undocumented in source. Be warned that the author may not have intended to support it.
getStruct
void* getStruct()

the main Gtk struct as a void*

setArrowTooltipMarkup
void setArrowTooltipMarkup(string 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

setArrowTooltipText
void setArrowTooltipText(string 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

setMenu
void setMenu(Widget 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

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.

Static functions

callBackShowMenu
void callBackShowMenu(GtkMenuToolButton* buttonStruct, MenuToolButton _menuToolButton)
Undocumented in source. Be warned that the author may not have intended to support it.

Variables

connectedSignals
int[string] connectedSignals;
gtkMenuToolButton
GtkMenuToolButton* gtkMenuToolButton;

the main Gtk struct

onShowMenuListeners
void delegate(MenuToolButton)[] onShowMenuListeners;
Undocumented in source.

Inherited Members

From ToolButton

gtkToolButton
GtkToolButton* gtkToolButton;

the main Gtk struct

getToolButtonStruct
GtkToolButton* getToolButtonStruct()
Undocumented in source. Be warned that the author may not have intended to support it.
getStruct
void* getStruct()

the main Gtk struct as a void*

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
__anonymous
mixin ActionableT!(GtkToolButton)
Undocumented in source.
connectedSignals
int[string] connectedSignals;
onClickedListeners
void delegate(ToolButton)[] onClickedListeners;
Undocumented in source.
addOnClicked
void addOnClicked(void delegate(ToolButton) dlg, ConnectFlags connectFlags)

This signal is emitted when the tool button is clicked with the mouse or activated with the keyboard. See Also GtkToolbar, GtkMenuToolButton, GtkToggleToolButton, GtkRadioToolButton, GtkSeparatorToolItem

callBackClicked
void callBackClicked(GtkToolButton* toolbuttonStruct, ToolButton _toolButton)
Undocumented in source. Be warned that the author may not have intended to support it.
setLabel
void setLabel(string 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, the label is determined by the "stock_id" property. If the "stock_id" property is also NULL, button will not have a label. Since 2.4

getLabel
string getLabel()

Returns the label used by the tool button, or NULL if the tool button doesn't have a label. or uses a the label from a stock item. The returned string is owned by GTK+, and must not be modified or freed. Since 2.4

setUseUnderline
void setUseUnderline(int useUnderline)

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

getUseUnderline
int getUseUnderline()

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(). Since 2.4

setStockId
void setStockId(string stockId)

Warning gtk_tool_button_set_stock_id has been deprecated since version 3.10 and should not be used in newly-written code. Use gtk_tool_button_set_icon_name() instead. Sets the name of the stock item. See gtk_tool_button_new_from_stock(). The stock_id property only has an effect if not overridden by non-NULL "label" and "icon_widget" properties. Since 2.4

getStockId
string getStockId()

Warning gtk_tool_button_get_stock_id has been deprecated since version 3.10 and should not be used in newly-written code. Use gtk_tool_button_get_icon_name() instead. Returns the name of the stock item. See gtk_tool_button_set_stock_id(). The returned string is owned by GTK+ and must not be freed or modifed. Since 2.4

setIconName
void setIconName(string iconName)

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", "icon_widget" and "stock_id" properties. Since 2.8

getIconName
string getIconName()

Returns the name of the themed icon for the tool button, see gtk_tool_button_set_icon_name(). Since 2.8

setIconWidget
void setIconWidget(Widget iconWidget)

Sets icon as the widget used as icon on button. If icon_widget is NULL the icon is determined by the "stock_id" property. If the "stock_id" property is also NULL, button will not have an icon. Since 2.4

getIconWidget
Widget getIconWidget()

Return the widget used as icon widget on button. See gtk_tool_button_set_icon_widget(). Since 2.4

setLabelWidget
void setLabelWidget(Widget labelWidget)

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, the label in the stock item determined by the "stock_id" property is used as label. If "stock_id" is also NULL, button does not have a label. Since 2.4

getLabelWidget
Widget getLabelWidget()

Returns the widget used as label on button. See gtk_tool_button_set_label_widget(). Since 2.4

Meta