Package: gtk

Class gtk-tool-item

Superclasses

Documented Subclasses

Direct Slots

is-important
The "is-important" property of type :boolean (Read / Write)
Whether the toolbar item is considered important. When true, toolbar buttons show text in :both-horiz mode.
Default value: nil
visible-horizontal
The "visible-horizontal" property of type :boolean (Read / Write)
Whether the toolbar item is visible when the toolbar is in a horizontal orientation.
Default value: true
visible-vertical
The "visible-vertical" property of type :boolean (Read / Write)
Whether the toolbar item is visible when the toolbar is in a vertical orientation.
Default value: true

Details

gtk-tool-item's are widgets that can appear on a toolbar. To create a toolbar item that contain something else than a button, use the gtk-tool-item-new function. Use the gtk-container-add function to add a child widget to the tool item.

For toolbar items that contain buttons, see the gtk-tool-button, gtk-toggle-tool-button and gtk-radio-tool-button classes.

See the gtk-toolbar class for a description of the toolbar widget, and gtk-tool-shell for a description of the tool shell interface.

Signal Details

The "create-menu-proxy" signal
 lambda (tool-item)   : Run Last      
This signal is emitted when the toolbar needs information from tool-item about whether the item should appear in the toolbar overflow menu. In response the tool item should either.
  • Call the gtk-tool-item-set-proxy-menu-item with a NULL pointer and return true to indicate that the item should not appear in the overflow menu,
  • call the gtk-tool-item-set-proxy-menu-item function with a new menu item and return true, or
  • return nil to indicate that the signal was not handled by the item. This means that the item will not appear in the overflow menu unless a later handler installs a menu item.
The toolbar may cache the result of this signal. When the tool item changes how it will respond to this signal it must call the gtk-tool-item-rebuild-menu function to invalidate the cache and ensure that the toolbar rebuilds its overflow menu.
tool-item
The object the signal was emitted on.
Returns
True if the signal was handled, nil if not.
The "toolbar-reconfigured" signal
 lambda (tool-item)   : Run Last      
This signal is emitted when some property of the toolbar that the item is a child of changes. For custom subclasses of gtk-tool-item, the default handler of this signal use the functions gtk-tool-shell-get-orientation, gtk-tool-shell-get-style, gtk-tool-shell-get-icon-size, or gtk-tool-shell-get-relief-style to find out what the toolbar should look like and change themselves accordingly.
tool-item
The object the signal was emitted on.
 

Slot Access Functions

Inherited Slot Access Functions

2013-6-1