Index Parent

Toolbar class

The Toolbar class is used to create image buttons bars.

Toolbar is a subclass of Toolbar.mcc so you must have Toolbar.mcc in MUI:Libs/MUI to use it. Toolbar.mcc is copyright of Benny Kjær Nielsen.

 

Toolbar.rxmec is also an ARexx shared library.

You don't have to worry about adding Toolbar.rxmec to the ARexx libraries list, because it is done automatically.

 

TBNotify
Adds a notification.
Synopsis
res = TBNotify(notifier,button,attr,value,target,method,parameters)
<notifier/V>,<id/N>,<attr/V>,<value>,<target/V>,<method/V>,{parms}
Function
Adds a notification from notifier, a Toolbar object button with id button, to target triggered by attr when it changes to value invoking method on target with parms.

You may use this function only with Toolbar objects, when you want to set up a notify triggered by a Toolbar button.

attr may be one of:

  • Active
  • Ghosted
  • Gone
  • Pressed
Inputs
notifier - the object that notifies
id - the button id of the bar
attr - the attribute that triggers the notification
value - the value of attr that causes the notification
target - the target of the notification. Specials values are:
  • _app - the application notifier belongs to
  • _win - the window notifier belongs to
  • _self - notifier itself
method - a valid an indirect method to invoke on target
parms - parameters for method 
Result
res - 0 for success or >0 for failure
The function may fail if:
[NO_OBJ] notifier or target not found
[NO_METHOD] method is not valid for target
[METHOD_NONOTIFY] method is direct-only
[BAD_NOTIFY] the notification can't be added for some reason
See
Notification

 

Bar attributes
Name Type Class Note
Description S I ARexx stem name, list of the buttons. If not supplied it is considered to be the object stem.
Help S GN  
Horiz B I  
ImageGhost S I Name of the ghosted images file.
ImageNormal S I Name of the normal images file.
ImageSelect S I Name of the selected images file.
Path S I Path to the images files. If supplied, images files are considered relative to this path.
Qualifier N GN  

 

Buttons attributes
Name Type Class Note
Exclude N I Mutual exclude mask. E.g. if button 10 excludes buttons 4 and 9, button 10 Exclude is 2**4+2**9
Flags S I One or more of:
  • Ghosted
  • Gone
  • Radio
  • Selected
  • Toggle
Help S I  
Text S I  
Type S I One of:
  • Button
  • Ignore
  • Space
Path S I Path to the images files. If supplied, images file are considered relative to this path.
Reusable B I  
Description S I ARexx stem name, list of the buttons. If not supplied it is considered to be the object stem.

 

Methods
Name Parameters Note
TBKillNotify   Use this instead of KillNotify()
TBreload <ImageNormal/N>,<ImageSelect>,<ImageGhost> Changes images
TBSet <id/N>,<what>,<value/N> Sets what of button id to value. what is one of:
  • Ghosted
  • Gone
  • Selected
TBSetAll <what>,<value/N> Sets what of all the buttons to value. what is one of:
  • Ghosted
  • Gone
  • Selected