GI.Gtk.Objects.ToolItem

GtkToolItems are widgets that can appear on a toolbar. To create a toolbar item that contain something else than a button, use toolItemNew. Use containerAdd to add a child widget to the tool item.

For toolbar items that contain buttons, see the ToolButton, ToggleToolButton and RadioToolButton classes.

See the Toolbar class for a description of the toolbar widget, and ToolShell for a description of the tool shell interface.

Exported types

newtype ToolItem

Constructors

ToolItem (ManagedPtr ToolItem)

Instances

GObject ToolItem

Methods

gobjectType :: ToolItem -> IO GType

IsImplementorIface ToolItem

IsObject ToolItem

IsWidget ToolItem

IsToolItem ToolItem

IsContainer ToolItem

IsBin ToolItem

IsBuildable ToolItem

IsActivatable ToolItem

class GObject o => IsToolItem o

Instances

(GObject a, UnknownAncestorError Constraint ToolItem a) => IsToolItem a

IsToolItem ToolItem

IsToolItem ToolButton

IsToolItem ToggleToolButton

IsToolItem SeparatorToolItem

IsToolItem MenuToolButton

IsToolItem RadioToolButton

toToolItem :: (MonadIO m, IsToolItem o) => o -> m ToolItem

noToolItem :: Maybe ToolItem

Methods

getEllipsizeMode

toolItemGetEllipsizeMode

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m EllipsizeMode

Returns: a EllipsizeMode indicating how text in toolItem should be ellipsized.

Returns the ellipsize mode used for toolItem. Custom subclasses of ToolItem should call this function to find out how text should be ellipsized.

Since: 2.20

getExpand

toolItemGetExpand

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: True if toolItem is allocated extra space.

Returns whether toolItem is allocated extra space. See toolItemSetExpand.

Since: 2.4

getHomogeneous

toolItemGetHomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: True if the item is the same size as other homogeneous items.

Returns whether toolItem is the same size as other homogeneous items. See toolItemSetHomogeneous.

Since: 2.4

getIconSize

toolItemGetIconSize

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Int32

Returns: a IconSize indicating the icon size used for toolItem

Returns the icon size used for toolItem. Custom subclasses of ToolItem should call this function to find out what size icons they should use.

Since: 2.4

getIsImportant

toolItemGetIsImportant

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: True if toolItem is considered important.

Returns whether toolItem is considered important. See toolItemSetIsImportant

Since: 2.4

getOrientation

toolItemGetOrientation

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Orientation

Returns: a Orientation indicating the orientation used for toolItem

Returns the orientation used for toolItem. Custom subclasses of ToolItem should call this function to find out what size icons they should use.

Since: 2.4

getProxyMenuItem

toolItemGetProxyMenuItem

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Text

menuItemId: a string used to identify the menu item

-> m Widget

Returns: The MenuItem passed to toolItemSetProxyMenuItem, if the menuItemIds match.

If menuItemId matches the string passed to toolItemSetProxyMenuItem return the corresponding MenuItem.

Custom subclasses of ToolItem should use this function to update their menu item when the ToolItem changes. That the menuItemIds must match ensures that a ToolItem will not inadvertently change a menu item that they did not create.

Since: 2.4

getReliefStyle

toolItemGetReliefStyle

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m ReliefStyle

Returns: a ReliefStyle indicating the relief style used for toolItem.

Returns the relief style of toolItem. See buttonSetRelief. Custom subclasses of ToolItem should call this function in the handler of the ToolItem::toolbar_reconfigured signal to find out the relief style of buttons.

Since: 2.4

getTextAlignment

toolItemGetTextAlignment

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem:

-> m Float

Returns: a gfloat indicating the horizontal text alignment used for toolItem

Returns the text alignment used for toolItem. Custom subclasses of ToolItem should call this function to find out how text should be aligned.

Since: 2.20

getTextOrientation

toolItemGetTextOrientation

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Orientation

Returns: a Orientation indicating the text orientation used for toolItem

Returns the text orientation used for toolItem. Custom subclasses of ToolItem should call this function to find out how text should be orientated.

Since: 2.20

getTextSizeGroup

toolItemGetTextSizeGroup

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m SizeGroup

Returns: a SizeGroup

Returns the size group used for labels in toolItem. Custom subclasses of ToolItem should call this function and use the size group for labels.

Since: 2.20

getToolbarStyle

toolItemGetToolbarStyle

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m ToolbarStyle

Returns: A ToolbarStyle indicating the toolbar style used for toolItem.

Returns the toolbar style used for toolItem. Custom subclasses of ToolItem should call this function in the handler of the GtkToolItem::toolbar_reconfigured signal to find out in what style the toolbar is displayed and change themselves accordingly

Possibilities are:

• ToolbarStyleBoth, meaning the tool item should show both an icon and a label, stacked vertically
• ToolbarStyleIcons, meaning the toolbar shows only icons
• ToolbarStyleText, meaning the tool item should only show text
• ToolbarStyleBothHoriz, meaning the tool item should show both an icon and a label, arranged horizontally

Since: 2.4

getUseDragWindow

toolItemGetUseDragWindow

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: True if toolItem uses a drag window.

Returns whether toolItem has a drag window. See toolItemSetUseDragWindow.

Since: 2.4

getVisibleHorizontal

toolItemGetVisibleHorizontal

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: True if toolItem is visible on toolbars that are docked horizontally.

Returns whether the toolItem is visible on toolbars that are docked horizontally.

Since: 2.4

getVisibleVertical

toolItemGetVisibleVertical

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Bool

Returns: Whether toolItem is visible when the toolbar is docked vertically

Returns whether toolItem is visible when the toolbar is docked vertically. See toolItemSetVisibleVertical.

Since: 2.4

new

toolItemNew

Arguments

:: (HasCallStack, MonadIO m)

=> m ToolItem

Returns: the new ToolItem

Creates a new ToolItem

Since: 2.4

rebuildMenu

toolItemRebuildMenu

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m ()

Calling this function signals to the toolbar that the overflow menu item for toolItem has changed. If the overflow menu is visible when this function it called, the menu will be rebuilt.

The function must be called when the tool item changes what it will do in response to the ToolItem::create-menu-proxy signal.

Since: 2.6

retrieveProxyMenuItem

toolItemRetrieveProxyMenuItem

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m Widget

Returns: The MenuItem that is going to appear in the overflow menu for toolItem.

Returns the MenuItem that was last set by toolItemSetProxyMenuItem, ie. the MenuItem that is going to appear in the overflow menu.

Since: 2.4

setExpand

toolItemSetExpand

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

expand: Whether toolItem is allocated extra space

-> m ()

Sets whether toolItem is allocated extra space when there is more room on the toolbar then needed for the items. The effect is that the item gets bigger when the toolbar gets bigger and smaller when the toolbar gets smaller.

Since: 2.4

setHomogeneous

toolItemSetHomogeneous

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

homogeneous: whether toolItem is the same size as other homogeneous items

-> m ()

Sets whether toolItem is to be allocated the same size as other homogeneous items. The effect is that all homogeneous items will have the same width as the widest of the items.

Since: 2.4

setIsImportant

toolItemSetIsImportant

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

isImportant: whether the tool item should be considered important

-> m ()

Sets whether toolItem should be considered important. The ToolButton class uses this property to determine whether to show or hide its label when the toolbar style is ToolbarStyleBothHoriz. The result is that only tool buttons with the “is_important” property set have labels, an effect known as “priority text”

Since: 2.4

setProxyMenuItem

toolItemSetProxyMenuItem

Arguments

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

=> a

toolItem: a ToolItem

-> Text

menuItemId: a string used to identify menuItem

-> b

menuItem: a MenuItem to be used in the overflow menu

-> m ()

Sets the MenuItem used in the toolbar overflow menu. The menuItemId is used to identify the caller of this function and should also be used with toolItemGetProxyMenuItem.

Since: 2.4

setTooltipMarkup

toolItemSetTooltipMarkup

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Text

markup: markup text to be used as tooltip for toolItem

-> m ()

Sets the markup text to be displayed as tooltip on the item. See widgetSetTooltipMarkup.

Since: 2.12

setTooltipText

toolItemSetTooltipText

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Text

text: text to be used as tooltip for toolItem

-> m ()

Sets the text to be displayed as tooltip on the item. See widgetSetTooltipText.

Since: 2.12

setUseDragWindow

toolItemSetUseDragWindow

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

useDragWindow: Whether toolItem has a drag window.

-> m ()

Sets whether toolItem has a drag window. When True the toolitem can be used as a drag source through widgetDragSourceSet. When toolItem has a drag window it will intercept all events, even those that would otherwise be sent to a child of toolItem.

Since: 2.4

setVisibleHorizontal

toolItemSetVisibleHorizontal

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

visibleHorizontal: Whether toolItem is visible when in horizontal mode

-> m ()

Sets whether toolItem is visible when the toolbar is docked horizontally.

Since: 2.4

setVisibleVertical

toolItemSetVisibleVertical

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> Bool

visibleVertical: whether toolItem is visible when the toolbar is in vertical mode

-> m ()

Sets whether toolItem is visible when the toolbar is docked vertically. Some tool items, such as text entries, are too wide to be useful on a vertically docked toolbar. If visibleVertical is False toolItem will not appear on toolbars that are docked vertically.

Since: 2.4

toolbarReconfigured

toolItemToolbarReconfigured

Arguments

:: (HasCallStack, MonadIO m, IsToolItem a)

=> a

toolItem: a ToolItem

-> m ()

Emits the signal ToolItem::toolbar_reconfigured on toolItem. Toolbar and other ToolShell implementations use this function to notify children, when some aspect of their configuration changes.

Since: 2.14

Properties

isImportant

constructToolItemIsImportant :: IsToolItem o => Bool -> IO (GValueConstruct o)

getToolItemIsImportant :: (MonadIO m, IsToolItem o) => o -> m Bool

setToolItemIsImportant :: (MonadIO m, IsToolItem o) => o -> Bool -> m ()

visibleHorizontal

constructToolItemVisibleHorizontal :: IsToolItem o => Bool -> IO (GValueConstruct o)

getToolItemVisibleHorizontal :: (MonadIO m, IsToolItem o) => o -> m Bool

setToolItemVisibleHorizontal :: (MonadIO m, IsToolItem o) => o -> Bool -> m ()

visibleVertical

constructToolItemVisibleVertical :: IsToolItem o => Bool -> IO (GValueConstruct o)

getToolItemVisibleVertical :: (MonadIO m, IsToolItem o) => o -> m Bool

setToolItemVisibleVertical :: (MonadIO m, IsToolItem o) => o -> Bool -> m ()

Signals

createMenuProxy

type C_ToolItemCreateMenuProxyCallback = Ptr () -> Ptr () -> IO CInt

type ToolItemCreateMenuProxyCallback = IO Bool

afterToolItemCreateMenuProxy :: (IsToolItem a, MonadIO m) => a -> ToolItemCreateMenuProxyCallback -> m SignalHandlerId

genClosure_ToolItemCreateMenuProxy :: ToolItemCreateMenuProxyCallback -> IO Closure

mk_ToolItemCreateMenuProxyCallback :: C_ToolItemCreateMenuProxyCallback -> IO (FunPtr C_ToolItemCreateMenuProxyCallback)

noToolItemCreateMenuProxyCallback :: Maybe ToolItemCreateMenuProxyCallback

onToolItemCreateMenuProxy :: (IsToolItem a, MonadIO m) => a -> ToolItemCreateMenuProxyCallback -> m SignalHandlerId

wrap_ToolItemCreateMenuProxyCallback :: ToolItemCreateMenuProxyCallback -> Ptr () -> Ptr () -> IO CInt

toolbarReconfigured

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

type ToolItemToolbarReconfiguredCallback = IO ()

afterToolItemToolbarReconfigured :: (IsToolItem a, MonadIO m) => a -> ToolItemToolbarReconfiguredCallback -> m SignalHandlerId

genClosure_ToolItemToolbarReconfigured :: ToolItemToolbarReconfiguredCallback -> IO Closure

mk_ToolItemToolbarReconfiguredCallback :: C_ToolItemToolbarReconfiguredCallback -> IO (FunPtr C_ToolItemToolbarReconfiguredCallback)

noToolItemToolbarReconfiguredCallback :: Maybe ToolItemToolbarReconfiguredCallback

onToolItemToolbarReconfigured :: (IsToolItem a, MonadIO m) => a -> ToolItemToolbarReconfiguredCallback -> m SignalHandlerId

wrap_ToolItemToolbarReconfiguredCallback :: ToolItemToolbarReconfiguredCallback -> Ptr () -> Ptr () -> IO ()