The Tools Menu

The Tools Menu allows for selection of the active toolbars and the icons (commands) that are to be shown on each toolbar. Descriptions of each toolbar icon are itemized in Section 2.19.

2.17.1 Customizing Toolbars

The Tools>Customize... option provides access to customizing the toolbar displays. Toolbars can be turned on/off and individually customized by adding and removing any number of buttons to them. Custom toolbars can also be created rather than editing existing configurations.

When selecting the Tools>Customize... option, the Customize dialog is displayed. This gives access to both a Toolbars tab and a Commands tab, as shown in Figure 2-114.

Figure 2-114. Customize Dialog: Toolbars Tab

The Toolbars tab facilitates the selection of those toolbars that are to be active and displayed on the interface. It also allows you to choose whether to show tooltip messages when the mouse pointer is held over the toolbar button. The tooltips identify the function of each toolbar button.

In the above figure all toolbars are selected to be visible on the interface except for the Custom Toolbar. The Custom Toolbar can be made active by checkmarking the Custom option. The resulting toolbar contains all the user definable buttons. Customization of these buttons is covered below (Section 2.17.2).

Toolbars can be rearranged in any position on the interface. They can also be dragged off the toolbar location and converted into floating windows.

The Tools Menu Users Manual

The Commands tab displays the individual toolbar categories and shows the buttons currently assigned to each bar. An example showing the File Toolbar and its associated buttons is shown in Figure 2-115. Clicking on one of the toolbar buttons will provide a description of its command func-tion. In this case it is the "Show or hide the output bar". A button can be removed from an active toolbar by clicking and dragging it from the toolbar to the Buttons area of the toolbar on the Com-mands tab. Likewise, a button in a particular toolbar category may be added to an active toolbar by dragging the icon of the button from the Commands tab to the desired location on the toolbar.

Many of the toolbar buttons (or toolbar commands) are duplicates of menu options and will open the same dialog.

Figure 2-115. Customize Dialog: Commands Tab

2.17.2 User Definable Buttons

Clicking on the Custom toolbar on the Toolbar tab of the Customize dialog will activate the Custom toolbar on the interface. This is a 30 button toolbar for which each button may be defined to invoke a user specified command when clicked.

Definitions for the custom buttons are contained in the C:\WINDOWS\psse30.ini file and added using a text editor. The commands are of the form:

Click to Get a Description

Siemens Power Transmission & Distribution, Inc., Power Technologies International 2-93

Users Manual The Tools Menu

filetype specifies the type of Automation file to be run when the button is clicked.

Options include:

PYTHON - A Python script file (*.py) RESPONSE - A Response file (*.idv) IPLAN - An IPLAN program (*.irf)

filename is the name of the Automation file to be executed by clicking the corresponding custom toolbar button. The filename should be in quotes and may contain the full pathname of the file.

tooltip is an optional description of the operation to be performed when the corre-sponding custom toolbar button is clicked. If specified, the description will popup when the mouse cursor is held over the custom toolbar button. If it is not specified, the name of the file, as specified by filename, will be displayed as the tooltip.

Example custom toolbar button definitions from within the psse30.ini file are shown below:

[Custom Definitions]

CUSTOM_BUTTON_1 = PYTHON,'C:\Program Files\PTI\PSSE30\EXAMPLE\OpenCase.py','Open savnw network and diagram'

CUSTOM_BUTTON_2 = RESPONSE,'C:\Program

Files\PTI\PSSE30\EXAMPLE\RunSolutAndReport.idv','Run solution and report'

With the above definitions specified, clicking the Custom toolbar button will invoke the Open-Case.py Python program. Placing the mouse pointer over the button will display the "Open savnw network and diagram" description. Similar behavior will be seen for the custom toolbar button labeled with a 2. Any custom toolbar buttons that do not have a corresponding CUSTOM_BUTTON definition in the psse30.ini file will be greyed out on the Custom toolbar and not selectable.

2.17.3 Creating Custom Toolbars

A custom designed toolbar can be created by selecting the New... button in the Toolbars tab of the Customize dialog shown in Figure 2-114. A new New Toolbar dialog window will be displayed into which a name for the new toolbar may be entered. When OK is clicked the new toolbar will appear within the list of toolbars and a small, free-floating toolbar window will appear on the PSS/E interface.

To add command buttons to the new toolbar, click on the Commands tab and drag the desired toolbar buttons to the new toolbar window. The new toolbar window can be docked to the toolbar area by dragging the window to the desired location on the toolbar and releasing the mouse.

To remove a user defined toolbar from the list of toolbars on the Toolbars tab, highlight the desired toolbar to be deleted and click Delete. The standard toolbars can only be reset to their default settings.

The Window Menu Users Manual