Index Parent

Speedbar class

The Speedbar class is used to create image buttons bars.

Speedbar is a subclass of Speedbar.mcc so you must have Speedbar.mcc in MUI:Libs/MUI to use it.
Speedbar.mcc is copyright of Simone Tellini.

Note that Speedbar is a group and any attribute of Group class may be used with it.

 

Speedbar.rxmec is also an ARexx shared library.

You dont have to worry about adding Speedbar.rxmec to the ARexx libraries list, because it is done automatically.

 

SBNotify
Adds a notification.
Synopsis
res = SBNotify(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 Speedbar 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 Speedbar objects, when you want to set up a notify triggered by a Speedbar button.

attr may be one of:

  • Disabled
  • Pressed
  • Selected
  • ShowMe
Inputs
notifier - the object that notifies
id - the id of a button of the bar (0,...)
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 reasone
See
Notification

 

 

ATTRIBUTES
Name Type Class Note
Active N ISGN This is the active button in a mutual exclude set of buttons. Note that if just one mutual exclude set is defined, this attribute may be used for notification of the active one; if more that one mutual exclude set is defined in the same Speedbar, this attribute reflects the last set active button in a set of mutual exclude buttons and notifications triggered by active buttons must be set up via the attribute Selected of any single button.
BorderLess B IS  
ImagesDrawer S I Path to the drawer where images are.
NoBrushes B G If, for any reason, the image of a button can't be read, this attribute is set to 1 and the Speedbar falls back to Text ViewMode.
RaisingFrame B IS  
SameHeight B I  
SameWidth B I  
SmallImages B IS  
Spacer S I Name of a datatype picture file to use as spacer
Spread B I  
StripUnderscore B I Drops the "_" in the text of the buttons. Default is 1.
Sunny B IS  
ViewMode M ISG G2N A numer or one of:
  • TextGFX
  • GFX
  • Text

 

ATTRIBUTES FOR A SINGLE BUTTON
Name Type Class Note
Exclude N I Mutual exclude mask. Note that more than one set of mutual exclude buttons may be specified in a single Speedbar. This attribute forces Flags to Immediate (Toggle is disabled)
Img S I Name of a datatype picture file or the string Spacer to add a space
Text S I  
Help S I  
Flags S I One of:
  • Disabled
  • Selected
  • Immediate
  • Toggle

 

METHODS
Name Parameters Note
SBGet <id/N><attr>,<var/V> Reads the value of the attribute attr of the button id and writes it in var.
attrs is one of:
  • Disabled
  • Selected
  • ShowMe
SBSet <id/N><attr>,<value/N> Set the attr of the button id to value.
attrs is one of:
  • Disabled
  • Selected
  • ShowMe

 

Example

    speedbar.SameSize=1
    speedbar.Horiz=1
    speedbar.RaisingFrame=0
    speedbar.Borderless=0
    speedbar.ImagesDrawer="Pics"
    speedbar.Spacer="Spacer"
     speedbar.0.Img="back.iff"
     speedbar.0.Text="Back"
     speedbar.1.Img="forward.iff"
     speedbar.1.Text="Forward"
     speedbar.2.Img="reload.iff"
     speedbar.2.Text="Reload"
     speedbar.2.Flags="Immediate"
     speedbar.3.Img="stop.iff"
     speedbar.3.Text="Stop"
     speedbar.4.Img="SPACER"
     speedbar.5.Img="home.iff"
     speedbar.5.Text="Home"
     speedbar.5.Flags="Immediate Selected"
     speedbar.5.Exclude=2**6
     speedbar.6.Img="find.iff"
     speedbar.6.Text="Find"
     speedbar.6.Flags="Immediate"
     speedbar.6.Exclude=2**5