add-tool

   

Adds a tool to the toolbar.

• (send a-wx:tool-bar add-tool id bitmap1 bitmap2 is-toggle x y client-data) ->  wx:tool-bar-tool% object
      id : small integer
      bitmap1 :  wx:bitmap% object
      bitmap2 = null :  wx:bitmap% object or null
      is-toggle = #f : boolean
      x = -1 : inexact real
      y = -1 : inexact real
      client-data :  wx:object% object

  The id argument is an identifier by which the tool may be identified in subsequent operations.

  The isToggle argument specifies whether the tool is a toggle or not: a toggle tool may be in two states, while a non-toggle tool is just a button.

  The bitmap1 argument is the primary tool bitmap for toggle and button tools. The bitmap argument specifies the ``on'' bitmap for a toggle tool; if it is null, either an inverted version of the primary bitmap is used for the ``on'' of a toggle tool (monochrome displays) or a black border is drawn around the tool (colour displays).

  The parameters x and y are used to specify an absolute position for the tool within the tool bar; if -1 is provided, a default position will be assigned such that the tool is placed next to the last tool inserted into the tool bar.

  The clientData argument is an value associated with the tool that can be retrieved later using get-tool-client-data.