Gtk.MenuToolButton¶

Subclasses:: None

Methods¶

Inherited:: Gtk.ToolButton (14), Gtk.ToolItem (28), Gtk.Bin (1), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Activatable (6), Gtk.Actionable (5)
Structs:: Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` (icon_widget, label)
class	`new_from_stock` (stock_id)
	`get_menu` ()
	`set_arrow_tooltip_markup` (markup)
	`set_arrow_tooltip_text` (text)
	`set_menu` (menu)

Virtual Methods¶

Inherited:: Gtk.ToolButton (1), Gtk.ToolItem (2), Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10), Gtk.Activatable (2), Gtk.Actionable (4)

do_show_menu ()

Properties¶

Inherited:: Gtk.ToolButton (6), Gtk.ToolItem (3), Gtk.Container (3), Gtk.Widget (39), Gtk.Activatable (2), Gtk.Actionable (2)

Name	Type	Flags	Short Description
`menu`	`Gtk.Menu`	r/w	The dropdown menu

Style Properties¶

Inherited:: Gtk.ToolButton (1), Gtk.Widget (17)

Signals¶

Inherited:: Gtk.ToolButton (1), Gtk.ToolItem (2), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Short Description
`show-menu`	The `::show-menu` signal is emitted before the menu is shown.

Fields¶

Inherited:: Gtk.ToolButton (1), Gtk.ToolItem (2), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Type	Access	Description
parent	`Gtk.ToolButton`	r

Class Details¶

class Gtk.MenuToolButton(*args, **kwargs)¶

Bases:: Gtk.ToolButton
Abstract:: No
Structure:: Gtk.MenuToolButtonClass

A Gtk.MenuToolButton is a Gtk.ToolItem that contains a button and a small additional button with an arrow. When clicked, the arrow button pops up a dropdown menu.

Use Gtk.MenuToolButton.new() to create a new Gtk.MenuToolButton.

Gtk.MenuToolButton as Gtk.Buildable

The Gtk.MenuToolButton implementation of the Gtk.Buildable 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:

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

classmethod new(icon_widget, label)[source]¶

Parameters:

icon_widget (Gtk.Widget or None) – a widget that will be used as icon widget, or None
label (str or None) – a string that will be used as label, or None

Returns:

the new Gtk.MenuToolButton

Return type:

Gtk.ToolItem

Creates a new Gtk.MenuToolButton using icon_widget as icon and label as label.

New in version 2.6.

classmethod new_from_stock(stock_id)[source]¶

Parameters:: stock_id (str) – the name of a stock item
Returns:: the new Gtk.MenuToolButton
Return type:: Gtk.ToolItem

Creates a new Gtk.MenuToolButton. The new Gtk.MenuToolButton will contain an icon and label from the stock item indicated by stock_id.

New in version 2.6.

Deprecated since version 3.10: Use Gtk.MenuToolButton.new() instead.

get_menu()[source]¶

Returns:: the Gtk.Menu associated with Gtk.MenuToolButton
Return type:: Gtk.Widget

Gets the Gtk.Menu associated with Gtk.MenuToolButton.

New in version 2.6.

set_arrow_tooltip_markup(markup)[source]¶

Parameters:: markup (str) – markup text to be used as tooltip text for button’s arrow button

Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu. See Gtk.ToolItem.set_tooltip_text() for setting a tooltip on the whole Gtk.MenuToolButton.

New in version 2.12.

set_arrow_tooltip_text(text)[source]¶

Parameters:: text (str) – text to be used as tooltip text for button’s arrow button

Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu. See Gtk.ToolItem.set_tooltip_text() for setting a tooltip on the whole Gtk.MenuToolButton.

New in version 2.12.

set_menu(menu)[source]¶

Parameters:: menu (Gtk.Widget) – the Gtk.Menu associated with Gtk.MenuToolButton

Sets the Gtk.Menu that is popped up when the user clicks on the arrow. If menu is None, the arrow button becomes insensitive.

New in version 2.6.

do_show_menu() virtual¶: Signal emitted before the menu is shown.

Signal Details¶

Gtk.MenuToolButton.signals.show_menu(menu_tool_button)¶

Signal Name:: show-menu
Flags:: RUN_FIRST
Parameters:: menu_tool_button (Gtk.MenuToolButton) – The object which received the signal

The ::show-menu signal is emitted before the menu is shown.

It can be used to populate the menu on demand, using Gtk.MenuToolButton.set_menu().

Note that even if you populate the menu dynamically in this way, you must set an empty menu on the Gtk.MenuToolButton beforehand, since the arrow is made insensitive if the menu is not set.

Property Details¶

Gtk.MenuToolButton.props.menu¶

Name:: menu
Type:: Gtk.Menu
Default Value:: None
Flags:: READABLE, WRITABLE

The dropdown menu