Graphics.UI.Gtk.MenuComboToolbar.MenuToolButton

A ToolItem containing a button with an additional dropdown menu

• Module available since Gtk+ version 2.6

Detail

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

Use menuToolButtonNew to create a new MenuToolButton. Use menuToolButtonNewFromStock to create a new MenuToolButton containing a stock item.

Class Hierarchy

| GObject
| +----Object
| +----Widget
| +----Container
| +----Bin
| +----ToolItem
| +----ToolButton
| +----MenuToolButton

Types

data MenuToolButton

Instances

Eq MenuToolButton

Ord MenuToolButton

GObjectClass MenuToolButton

MenuToolButtonClass MenuToolButton

ToolButtonClass MenuToolButton

ToolItemClass MenuToolButton

BinClass MenuToolButton

ContainerClass MenuToolButton

WidgetClass MenuToolButton

ObjectClass MenuToolButton

class ToolButtonClass o => MenuToolButtonClass o

Instances

MenuToolButtonClass MenuToolButton

castToMenuToolButton :: GObjectClass obj => obj -> MenuToolButton

gTypeMenuToolButton :: GType

toMenuToolButton :: MenuToolButtonClass o => o -> MenuToolButton

Constructors

menuToolButtonNew

Arguments

:: (WidgetClass iconWidget, GlibString string)

=> Maybe iconWidget

iconWidget - a widget that will be used as icon widget, or Nothing

-> Maybe string

label - a string that will be used as label, or Nothing

-> IO MenuToolButton

Creates a new MenuToolButton using iconWidget as icon and label as label.

menuToolButtonNewFromStock

Arguments

:: StockId

stockId - the name of a stock item

-> IO MenuToolButton

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

Methods

menuToolButtonSetMenu

Arguments

:: (MenuToolButtonClass self, MenuClass menu)

=> self

-> Maybe menu

menu - the Menu associated with MenuToolButton

-> IO ()

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

menuToolButtonGetMenu :: MenuToolButtonClass self => self -> IO (Maybe Menu)

Gets the Menu associated with MenuToolButton.

menuToolButtonSetArrowTooltip

Arguments

:: (MenuToolButtonClass self, GlibString string)

=> self

-> Tooltips

tooltips - the Tooltips object to be used

-> string

tipText - text to be used as tooltip text for tool item

-> string

tipPrivate - text to be used as private tooltip text

-> IO ()

Sets the Tooltips object to be used for arrow button which pops up the menu. See toolItemSetTooltip for setting a tooltip on the whole MenuToolButton.

menuToolButtonSetArrowTooltipText

Arguments

:: (MenuToolButtonClass self, GlibString string)

=> self

-> string

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

-> IO ()

Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu. See toolItemSetTooltip for setting a tooltip on the whole MenuToolButton.

• Available since Gtk+ version 2.12

menuToolButtonSetArrowTooltipMarkup

Arguments

:: (MenuToolButtonClass self, GlibString markup)

=> self

-> markup

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

-> IO ()

Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu. See toolItemSetTooltip for setting a tooltip on the whole MenuToolButton.

• Available since Gtk+ version 2.12

Attributes

menuToolButtonMenu :: (MenuToolButtonClass self, MenuClass menu) => ReadWriteAttr self (Maybe Menu) (Maybe menu)

The dropdown menu.

Signals

onShowMenu :: MenuToolButtonClass self => self -> IO () -> IO (ConnectId self)

afterShowMenu :: MenuToolButtonClass self => self -> IO () -> IO (ConnectId self)