5 
The Toolbar

This chapter describes how to use and redefine the toolbar.

Using The Toolbar

The toolbar, displayed below the menu bar by default, provides a quick way of actioning commands or displaying setup dialog boxes by just clicking a button.

The toolbar contains a series of buttons with graphical representations of their functions. These buttons are predefined with functions found in the setup menus and are described in the next section. You can redefine all the buttons and add or remove buttons from the toolbar using options in the Button Tools dialog box, which is described later.

The Predefined Button Tools

The toolbar displayed by default contains a series of buttons defined with functions found in the setup menus. These functions are listed below and described in the Setup Menus chapter.

       Displays the New Connection dialog box for making a serial or network host connection.

       Displays the Open Session dialog box. This enables you to load a particular setup configuration.

       Displays the Save Session As dialog box. This enables you to specify how the current session configuration is to be saved.

       Copies selected data to the clipboard.

       Pastes clipboard data at the current cursor position.

       Displays the Printer Setup dialog box. This enables you to select any printer that is configured in Microsoft Windows.

       Produces a hardcopy of screen data.

       Displays the Attributes dialog box. This enables you to specify the colours used in the emulation workspace and how text with attributes is displayed.

       Displays the Keyboard Macros dialog box. This shows the mapping of your keyboard and enables you to redefine the function of keys.

       Displays the Soft Buttons dialog box for defining the function of soft buttons.

       Displays the Mouse Button Actions dialog box for assigning up to six functions to the left mouse button.

       Displays the Button Tools dialog box for redefining the toolbar.

       Displays information on this version of the terminal emulation.

Redefining The Toolbar

Clicking the last button in the default toolbar, or selecting Button Tools from the Settings menu will display a dialog box which enables you to redefine the toolbar.

The maximum number of buttons that can be displayed in the toolbar depends on the display resolution and the size of the window.

A button tool is defined in two stages. The first stage is to specify the button bitmap for display in the toolbar and the second stage is to assign a function to it.

Adding Button Bitmaps

Clicking the arrow button in the Current Tool box will display a list box showing all the button bitmaps in the order displayed in the toolbar, together with their functions. The Current Tool will be highlighted in this list. When you add a new button to the toolbar it is positioned to the left of the button currently selected in this list. Select the current tool then close the list box by clicking the arrow button again.

To add a new button, select a button bitmap from the Buttons list box then click the Insert at Current button. Note that the function of this new button will be the same as that of the previously selected button tool until you redefine it. You can insert a space before the current button tool as it is displayed in the toolbar by selecting [Space] in the Commands list box then clicking the Insert at Current button.

You are not restricted to the set of predefined button bitmaps displayed in the Buttons list box. You can add your own customised buttons to the bottom of the list by clicking the Add Custom... button. This will display the Load Custom Bitmap dialog box which enables you to select a bitmap file from which a button will be automatically generated.

Specify the name of the bitmap file to use then click the OK button. The dialog box will close and you will see the new button bitmap highlighted at the bottom of the Buttons list box.

If you want to delete a custom button from the Buttons list box, select the button bitmap then click the Delete Custom button. DO NOT click the Delete Current button as this will remove the currently selected button tool from the toolbar. Note that you cannot delete the predefined button bitmaps displayed by default.

Assigning Functions To Buttons

You can assign a variety of functions to the buttons. You can either enter a definition of your own or you can select a menu command from the Commands list box.

The buttons displayed in the toolbar by default are defined with some of the functions listed in the setup menus. These enable you to quickly action a command or display a setup dialog box without having to display the menu first. The Commands list box displays all the menu items that can be assigned to the buttons.

To assign a function to a button, make sure that the button bitmap required is displayed in the Current Tool box, enter the new definition in the associated text box or select a menu command from the Commands list box, then click the Change Current button to action the change. The toolbar will not be updated until you click the OK button to close the dialog box.

Entering Control Characters

You can enter a control character in a button tool definition either as the control key character equivalent or the decimal value of the ASCII character. For example, the control character for the Return key function, CR (carriage return), can be entered by typing the characters ^ and M, representing the keys Ctrl + M which, when pressed together would generate the CR code.

Decimal values are entered as three-digit numbers immediately preceded by an underscore character. Values with only two digits must be preceded by a zero. For example, the decimal value of CR is 13, so this would be entered as _013. Refer to the Character Sets appendix for code and decimal references.

Key Combinations & Sequences

You can program a button tool to perform the function of a combination or sequence of keys. For example, you can cause a button to perform the same function as pressing the keys Alt + F4 together, or pressing the keys F2 then F3 then F4.

Keys are identified by their virtual key names as listed in the Virtual Key Names appendix. The name has to be enclosed by the < and > characters in the Current Tool text box. You may omit the VK_, VT_ parts (etc.) of the virtual key name.

To program a button so that it performs the same function as pressing two or more other keys together, type the < character followed by the virtual key names linked together with + characters and ending with the > character. For example, to program a button so that when it is clicked it performs the same function as pressing the keys Alt + F4 together, enter the following characters in the Current Tool text box:

<ALT+F4>

To program a button so that it performs the same function as pressing a sequence of keys one after the other, enter each virtual key name in the order required, enclosing each virtual key name with the < and > characters. Each enclosed virtual key name must immediately follow the previous enclosed virtual key name with no spaces. For example, to program a button so that when it is clicked it performs the same function as pressing the keys F2 then F3 then F4 enter the following characters in the Current Tool text box:

<F2><F3><F4>

Removing Button Tools

You can remove individual button tools from the toolbar or you can remove the entire toolbar from the display.

A button tool is removed by selecting it in the Current Tool list box then clicking the Delete Current button. To remove the toolbar from the display, deselect the Visible check box.

Saving The Button Tools

When you have finished defining button tools you can save them so that they will be reasserted when the emulator is loaded or reset by selecting Save Session in the File menu.

Notes