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

    Sections