Introduction to ToolExt.ini

You can create your own buttons to be called from the configuration toolbox by writing your own modules. This advanced functionality enables you to create customized tools to extend the capabilities of your VTS applications. The module to call belongs to a VTS service called ToolExt (for Toolbox Extensions).

VTS provides you with the option of configuring these buttons to appear in the configuration toolbox. The configuration information for your custom configuration toolbox buttons should be added to a special configuration file which should literally be named "ToolExt.ini", and should be saved in your application's directory.

ToolExt.ini should be a comma-separated value file with one tool button per line. (Comments can be added on their own lines by prefacing them with a semi-colon.) Each line should follow the syntax demonstrated below:

Tooltip Description, Button Bitmap, Module Name, Module Parameters

Each of these parameters is described below:

Tooltip Description

The description or label you wish to appear on the tooltip that opens when the mouse pointer hovers over the new Configuration Toolbox button.

ButtonBitmap

The filename of a bitmap to be displayed on the button. If the bitmap is not located within the application directory, you should include the full path to the location where the bitmap is stored.  Any image format may be used, but it will be helpful if the overall size is 29 by 29 pixels.  Color 7 will be transparent.

ModuleName

The name of the module to call when the button is clicked.  The module should be defined in the application’s AppMod.src file.

The module would normally be used for application configuration, and should be designed so that it can be displayed in a dialog box style window.

OptionalParameters 

Zero to 32 optional parameter values to be passed to the called module.