debugbutton

Format: debugbutton [num] [name] [[c=]command] [[i=]iconname] [[h=]helpstring] [[t=]tooltip]

This command adds a new icon button to the debugger toolbar.

command, iconname, helpstring, and tooltip are all either single words, or quoted strings. Quoted string are of the form:
"This is a quoted string."

There are several forms of the command:
Form Meaning
debugbutton
By itself, the command lists all the defined buttons. Note that the quit button and the spacer before it are never listed. Those buttons are special and can not be modified or deleted.
debugbutton 0
Deletes all buttons (except the quit button and its spacer).
debugbutton num
Deletes the button numbered num.
debugbutton num name [...]
Replaces the button numbered num
debugbutton name
Deletes the button named name
debugbutton name [...]
If a button named name exists, the button is replaced. Otherwise a new button named name is added to the end of the debugger toolbar.

command is the command executed when the button is pressed. You may use semicolons in the command to execute multiple commands. For example: debugbutton printxy c="print x;print y".

iconname is the name of the icon associated with the button. If not specified, then the first letter of the command name will be used as the icon for the button.

iconname may either be the name of one of MULTI's built-in icons (see below for how to obtain a list of these names), or it may be the filename of a bitmap you have created yourself. If the filename is not an absolute filename, it is assumed to be relative to the directory where MULTI is installed.

If you create your own bitmap file, it must end in a .bmp extension and must be in the uncompressed 16-color Windows Bitmap format. Other color depths are not supported, and compressed bitmaps are not supported. An easy way to create such bitmaps is to use the Paint accessory under Microsoft Windows, and make sure you choose "16 Color Bitmap" in the "Save as type" drop-down list box of the "Save As" dialog.

The built-in icons in MULTI are 20 pixels wide by 20 pixels tall, so your buttons will look best if you also use this size for your custom bitmaps.

By default, the color light gray in your custom icons will become transparent. You can specify additional color translations for your custom icon by appending a string of the form "oldcolor1=newcolor1&oldcolor2=newcolor2" with a question mark to the end of your bitmap filename. For example:
debugbutton Hello c="echo hello" i="/home/user/hello.bmp?black=fg&dkgray=shadow&white=highlight" h="Say hello"

You can use the following values for oldcolor and newcolor:
Oldcolor (R,G,B values) Possible values for newcolor
white (255,255,255)
white (default)
highlight
ltgray (192,192,192)
ltgray
transparent (default)
dkgray (128,128,128)
dkgray (default)
shadow
black (0,0,0)
black (default)
fg

To access the list of MULTI's built-in icon names along with what they look like, first open the Options dialog box by doing one of the following:

Then choose the Debugger tab, and click the button "Configure Debugger Buttons...".

helpstring is the help text that appears at the botton of the window when the mouse moves over the button.

tooltip is the tooltip text that appears when you move your mouse over the button and wait. If you do not specify a tooltip, the name of the button will be used.


Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.