Configure Tools Menu

Use the Configure Tools Menu dialog to add user defined items to the Tools menu.

Configure Tools Grid

Each item that you add to this grid will appear at the end of the Studio's Tools menu. Use the Add button to create an empty row then fill out each column appropriately.

Label

Enter the text that will be displayed in the Tools menu for the current row.

Command

Enter the command that will be executed when the current row is selected in the Tools menu. You should enter the path and filename of an external program to be launched. For example...

“C:\Programs Files\Notepad++.exe”

This would launch the application Notepad++.exe

Parameters

Enter any parameters that will be passed to the application called in the Command column. For example “C:\Readme.txt”. Combined with the Command example (above) this would launch the Notepad++.exe application and open the file “C:\Readme.txt”

Separator

Check this box to place a separator on the Tools menu above the current row.

Command Line Replacement Tags

The command line column of the Configure Tools grid supports a set of special tag strings that are evaluated and replaced by text each time the menu option is selected. The following tags strings are supported.

Tag

Replacement

<workspace>

This tag is replaced by the filename and path of the current workspace's configuration file. e.g. "c:\projects\orders\orders.sws"

<home>

This tag is replaced with the path to the current workspace's home (root) folder (e.g. psHome).

<project>

This tag is replaced by the filename and path of the current project's source file. e.g. "c:\projects\orders\programs\order.src".

<file>

This tag is replaced by the filename and path of the file currently being edited in the Studio. e.g. "c:\projects\orders\appsrc\customer.vw".

<application>

This tag is replaced by the filename and path of the current project's compiled executable (.exe). The <application> tag is also supported as a replacement tag in the “Command” column.

<line0>

This tag is replaced by the line number (zero-based) of the currently selected line of the currently edited file.

<line1>

This tag is replaced by the line number (one-based) of the currently selected line of the currently edited file.

<save>

Saves the current source file before executing the command. Nothing is added to the parameters by this tag.

<saveall>

Saves all open files and table definitions before executing the command.  Nothing is added to the parameters by this tag.

 

Note

Command line tags strings are case-insensitive.

Examples

 

Command: “Notepad.exe”

Command Line: “<file>”

This would launch the notepad application and pass to it the filename and path of the file currently being edited in the Studio.

Command: "DBBldr.exe"

Command Line: "–x<workspace>"

This would launch the Database Builder tool and pass the parameter –x followed by the name and path of the currently open workspace .sws file (enclosed in double quotes).

Command: "<application>"

This would launch the current project's application (.exe) outside of the Studio debug environment.

Command: "SignCode"

Command Line: '-spc "c:\build area\MyCert.spc" -v "c:\build area\MyKey.pvk" -t http://timestamp.verisign.com/scripts/timstamp.dll "<application>"'

This would launch the SignCode application to digitally sign the current project's application (.exe).

Command: “Notepad++.exe”

Command Line: “-nosession -n<line1> <file>”

This would open the current file in Notepad++ and move the cursor to the same line number as the currently selected line in the editor for this file.

Operations

 

Move Up

Click Move Up to move the currently selected row in the grid up one position in the menu.

Move Down

Click Move Down to move the currently selected row in the grid down one position in the menu.

Add

Click Add to add a new (empty) row to the Tools menu.

Remove

Click Remove to remove the currently selected row from the Tools menu.

OK

Click OK to save changes to the Tools menu and close the dialog.

Cancel

Click Cancel to close the dialog and discard all changes.