GI.Gtk.Objects.MenuToolButton

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.

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: > >class="GtkMenuToolButton" > type="menu" > class="GtkMenu"/ > /child >/object

Exported types

newtype MenuToolButton

Constructors

MenuToolButton (ManagedPtr MenuToolButton)

Instances

GObject MenuToolButton

Methods

gobjectType :: MenuToolButton -> IO GType

IsImplementorIface MenuToolButton

IsObject MenuToolButton

IsWidget MenuToolButton

IsToolItem MenuToolButton

IsToolButton MenuToolButton

IsContainer MenuToolButton

IsBin MenuToolButton

IsBuildable MenuToolButton

IsActivatable MenuToolButton

IsActionable MenuToolButton

IsMenuToolButton MenuToolButton

class GObject o => IsMenuToolButton o

Instances

(GObject a, UnknownAncestorError Constraint MenuToolButton a) => IsMenuToolButton a

IsMenuToolButton MenuToolButton

toMenuToolButton :: (MonadIO m, IsMenuToolButton o) => o -> m MenuToolButton

noMenuToolButton :: Maybe MenuToolButton

Methods

getMenu

menuToolButtonGetMenu

Arguments

:: (HasCallStack, MonadIO m, IsMenuToolButton a)

=> a

button: a MenuToolButton

-> m Widget

Returns: the Menu associated with MenuToolButton

Gets the Menu associated with MenuToolButton.

Since: 2.6

new

menuToolButtonNew

Arguments

:: (HasCallStack, MonadIO m, IsWidget a)

=> Maybe a

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

-> Maybe Text

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

-> m MenuToolButton

Returns: the new MenuToolButton

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

Since: 2.6

newFromStock

menuToolButtonNewFromStock

Arguments

:: (HasCallStack, MonadIO m)

=> Text

stockId: the name of a stock item

-> m MenuToolButton

Returns: the new MenuToolButton

Deprecated: (Since version 3.10)Use menuToolButtonNew instead.

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

Since: 2.6

setArrowTooltipMarkup

menuToolButtonSetArrowTooltipMarkup

Arguments

:: (HasCallStack, MonadIO m, IsMenuToolButton a)

=> a

button: a MenuToolButton

-> Text

markup: markup text to be used as tooltip text for button’s arrow button

-> m ()

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

Since: 2.12

setArrowTooltipText

menuToolButtonSetArrowTooltipText

Arguments

:: (HasCallStack, MonadIO m, IsMenuToolButton a)

=> a

button: a MenuToolButton

-> Text

text: text to be used as tooltip text for button’s arrow button

-> m ()

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

Since: 2.12

setMenu

menuToolButtonSetMenu

Arguments

:: (HasCallStack, MonadIO m, IsMenuToolButton a, IsWidget b)

=> a

button: a MenuToolButton

-> b

menu: the Menu associated with MenuToolButton

-> m ()

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

Since: 2.6

Properties

menu

clearMenuToolButtonMenu :: (MonadIO m, IsMenuToolButton o) => o -> m ()

constructMenuToolButtonMenu :: (IsMenuToolButton o, IsMenu a) => a -> IO (GValueConstruct o)

getMenuToolButtonMenu :: (MonadIO m, IsMenuToolButton o) => o -> m (Maybe Menu)

setMenuToolButtonMenu :: (MonadIO m, IsMenuToolButton o, IsMenu a) => o -> a -> m ()

Signals

showMenu

type C_MenuToolButtonShowMenuCallback = Ptr () -> Ptr () -> IO ()

type MenuToolButtonShowMenuCallback = IO ()

afterMenuToolButtonShowMenu :: (IsMenuToolButton a, MonadIO m) => a -> MenuToolButtonShowMenuCallback -> m SignalHandlerId

genClosure_MenuToolButtonShowMenu :: MenuToolButtonShowMenuCallback -> IO Closure

mk_MenuToolButtonShowMenuCallback :: C_MenuToolButtonShowMenuCallback -> IO (FunPtr C_MenuToolButtonShowMenuCallback)

noMenuToolButtonShowMenuCallback :: Maybe MenuToolButtonShowMenuCallback

onMenuToolButtonShowMenu :: (IsMenuToolButton a, MonadIO m) => a -> MenuToolButtonShowMenuCallback -> m SignalHandlerId

wrap_MenuToolButtonShowMenuCallback :: MenuToolButtonShowMenuCallback -> Ptr () -> Ptr () -> IO ()