Customize Tools Menu Dialog Box
Select Tools»Customize to launch the Customize Tools Menu dialog box.
The Customize Tools Menu dialog box contains the following options:
- Tools Menu—Contains a list of tools menu items. When you select an item in the list control, all other controls below the list display the settings for the selected item. The list control displays the following columns:
- Item Text—Displays the result of evaluating the Item Text Expression.
- Type—Displays the type of menu item, such as command, sequence, submenu, and sequence file.
- Add—Inserts a new menu item above the selected item in the Tools menu list by launching the Add Tools Menu Item dialog box. You can add the following types of menu items:
- Command—Invokes a Windows executable.
- Sequence—Initiates an execution on a sequence in a sequence file.
- Submenu—Contains additional menu items.
- Sequence File—Creates a submenu that lists all sequences in a sequence file as menu items.
- Remove—Deletes the selected menu item from the Tools menu.
- Move Up and Move Down—Changes the order of items within the menu or submenus.
- Expand—Allows you to view the tools menu items in a submenu.
- Collapse—Allows you to step out of an item in a submenu.
- Item Text Expression—Specifies the expression that evaluates to the literal text to display for the tools menu item.
- Insert Separator Before Item—Specifies if a menu separator precedes the tools menu item.
- Hidden Expression—Allows you to specify an expression that determines when a tools menu item is hidden. If the field is empty, TestStand treats the expression as False.
Note TestStand evaluates the Hidden Expression in the Engine.GetRunTimeToolMenuItems method. The sequence editor constructs the Tools menu by calling this method each time you click the Tools menu in the sequence editor. - Enable Expression—Visible for Command and Sequence item types. This option lets you specify an expression that determines when the menu item is enabled. The expression must return True to enable the menu item and False to dim the menu item.
- Command—Specifies the executable path. This option is only visible for the Command menu type.
- Arguments—Specifies the command-line arguments. This option is only visible for the Command menu type.
- Initial Directory—Specifies the initial working directory for the executable. This option is only visible for the Command menu type.
- Edits Selected File—Visible for Sequence and Sequence File item types. Set this option for Tools menu items you add that edit the selected sequence file. This option advises the sequence editor to prompt the user to check out the selected file from source control if it is not already checked out.
- Sequence File and Sequence—Specifies the target for the Sequence File and Sequence menu item types.
- Export Items To File—Launches the Export Tools Menu dialog box, which contains a list of tools menu items.
See Also