Adding toolbar buttons

In the Add Button window, you can create a new button to launch an applet, play a macro, go to a specified URL, run an application, assign a keyboard function, or access basic menu items.

General steps for adding buttons: (For more information on individual button types, refer to the list below.)

1. Select the type of button you wish to add from the list on the left.
2. In the Toolbar Text field, type the text label you want to appear on the button.
3. In the Description field, provide a description of the button function; this description will appear at the bottom of the Client window when the mouse rolls over the button.
4. Select the icon for your button.
   • Click Default to accept the default icon shown in the window.
   • Click Change to customize the button appearance with your own icon. The Change window appears, which allows you to type a URL path for an icon image or the pathname of a GIF file. (If the size of the GIF file is not 16x16, the file will be resized to 16x16, and the image may be unclear. Also, depending on size of the image file and download time, it may take awhile for the new image to appear.)
5. Click Add to place your button on the toolbar.

Applet

Application

URL

Macro

File

Edit

View

Communication

Actions

Help

Keystroke

Applet Type the full class name of the applet that you want Z and I Emulator for Web to launch when the button is clicked. You must follow the rules described in Run applet.

Application According to your platform syntax, specify the full application path followed by any application parameters.

URL Specify a URL address to open in your default browser.

Macro You can create a button that plays a macro. If you specify a parameter list for the macro, the parameter list is saved as part of the button definition.

• Macro Location: Depending on how the administrator has configured the session, available macros reside in the Current Session, Personal Library, Server Library and any user-defined libraries. When macros are placed in a library, rather than in the Current Session, they can be easily shared by multiple users and/or sessions. See Sharing and reusing component definitions for more information.

• User-defined Locations: If you want to use a macro in a location other than those listed, you can use the Add... button to specify the new path. Z and I Emulator for Web will remember up to three user-defined library locations; after that the least-recently-used location will be dropped. You can also explicitly delete user locations with the Delete button. Note that when you click on the toolbar button to run the macro, if the macro is in a user location, Z and I Emulator for Web will search all of the current user locations for the named macro. See Searching user-defined macro locations for more information.

• Select a Macro: Select the name of the macro for which you want to create a button. (To see the macro's properties, right-click the macro name and click Properties.)

• Parameters (optional): If the macro requires or permits a parameter list, type the parameter list into this input field.

  • The parameter list is saved in the toolbar as one of the properties of the new button.
  • For information on how to specify a parameter list see Specifying a parameter list for a macro.
  • For information on other locations where you can specify a parameter list for a macro see Locations where you can specify a parameter list for a macro.
  • For a more detailed treatment of parameter lists for macros Passing a parameter list to a macro in the Macro Programming Guide (primarily for session administrators and macro writers).

• Toolbar text: You can:

  • Leave this field blank to have Z and I Emulator for Web use the default text. The default text is the name of the macro.
  • Specify some other text by typing the text into this field.

File You can create a button to represent any option of the File menu.

Edit You can create a button to represent any option of the Edit menu.

View You can create a button to represent any option of the View menu.

Communication You can create a button to represent any option of the Communication menu.

Actions You can create a button to represent any option of the Actions menu.

Help You can create a button to represent any option of the Help menu.

Keystroke Assign a keyboard function (from the Characters, Host Functions, or Custom Functions categories) to a toolbar button.

Certain keyboard functions are predefined with Z and I Emulator for Web for remapping. The Custom Function Editor allows you to define and maintain new keyboard functions, called custom functions, without having to edit HTML and JavaScript files. These new functions may be assigned to a toolbar button.

On the Keystroke page, choose from a list of keystrokes to create a button. Then, when you select that button, it will function as if the assigned keys have been pressed.

This option does not appear on FTP sessions.

For more information on toolbar customization options, read

Customize Toolbar

.