Documentation‎ > ‎Toolbars‎ > ‎gnocl::toolBar‎ > ‎

item

A button like item in a toolbar.

Synopsis

toolBarId add item [-option value...]

Options

-icon
type: percent-string (default: "")
Icon of the item.
-name
type: string
Name of the widget, can be used to set options in an rc file.
-onClicked
type: string (default: "")
Tcl command to be executed if the button is clicked. Before evaluation the following percent strings are substituted:

%w    widget name
-onButtonPress
type: string (default: "")
Tcl command which is executed if a mouse button is press inside the widget. Before evaluation the following percent strings are substituted:

%w    widget name
%t    type of event: one of buttonPress, button2Press or button3Press
%x    x coordinate
%y    y coordinate
%b    button number
%s    state of the buttons and modifiers (bitmask)
-onButtonRelease
type: string (default: "")
Tcl command which is executed if a mouse button is released inside the widget. Before evaluation the following percent strings are substituted:

%w    widget name
%t    type of event: always buttonRelease
%x    x coordinate
%y    y coordinate
%b    button number
%s    state of the buttons and modifiers (bitmask)
-onPopupMenu
type: string (default: "")
Tcl command which is executed if the "popup-menu" signal is received, which is normally the case if the user presses Shift-F10. Before evaluation the following percent strings are substituted:

%w    widget name
-onShowHelp
type: string (default: "")
Tcl command which is executed in the global scope if the "show-help" signal is received, which is normally the case if the user presses F1 or Ctrl-F1. Before evaluation the following percent strings are substituted:

%w    widget name
%h    help type: either "whatsThis" or "tooltip"
-sensitive
type: boolean (default: 1)
Whether or not the item is sensitive to user input.
-text
type: percent-string (default: "")
Text or name of stock item.
-tooltip
type: string
Message that appear next to this widget when the mouse pointer is held over it for a short amount of time.
-visible
type: boolean (default: 1)
Whether or not the item is visible.

Description

A toolbar item executes a command on mouse click.

Commands

id delete
Deletes the widget and the associated tcl command.
id configure [-option value...]
Configures the widget. Option may have any of the values accepted on creation of the widget.



Comments