Toolbar files

Overview: toolbar files

The bottom of the emulation window typically contains buttons for frequently used requests. By using the mouse to click this toolbar, you can trigger the actions assigned to the buttons, for example, F1: send the F1 key to the host.

The structure of the toolbar can be customized as required.

• System administrators usually perform these customizations when configuring the system: From the default menus, administrators select the appropriate menus for their implementation and make the menus available for their users as toolbar files.
• From this list, users simply select the toolbar file that is appropriate for their needs.
  You can also specify where to position the toolbar, for example, in the lower or upper area of the emulation window.
• If necessary, individual changes can be made to the toolbar using the toolbar editor and then saved as toolbar files.

The structure of the settings file is described here for your reference. However, we recommend that you always make changes using the toolbar editor:

• It can be very time-consuming to completely re-assign the settings.
• You also require good knowledge of JavaScript and the LogWeb/Ajax API to do this.

Toolbar: lwh.keys.arr

The toolbar contains buttons that trigger special actions. These are terminal-specific and grouped in the toolbar files in the lwh.keys.arr[] array.

When loading the terminal file, this definition is evaluated by lwh.keys.gen().

Content of lwh.keys.arr:

• In its simplest form, an array contains only a list of host functions. These parameters label the buttons and transfer the respective host function to the host when triggered by lwk.send(..):

  lwh.keys.arr =
  [
     "PF1" , "PF2" , "PF3" , "PF4" , "PF5" , "PF6" , "PF7" , "PF8" , "PF9" , "PF10", "PF11", "PF12",
     "PF13", "PF14", "PF15", "PF16", "PF17", "PF18", "PF19", "PF20", "PF21", "PF22", "PF23", "PF24",
     "ENTER","PA1", "PA2", "PA3", "CLEAR", "CURSEL"
  ];
  

• The special entry "|" results in a line break at this point:

  lwh.keys.arr =
  [
     "PF1" , "PF2" , "PF3" , "PF4" , "PF5" , "PF6" , "PF7" , "PF8" , "PF9" , "PF10", "PF11", "PF12",
     "|",
     "PF13", "PF14", "PF15", "PF16", "PF17", "PF18", "PF19", "PF20", "PF21", "PF22", "PF23", "PF24",
     "|",
     "ENTER","PA1", "PA2", "PA3", "CLEAR", "CURSEL"
  ];
  

• If you want the button to be labeled differently from the host function, enter both the text and the function to be called up (separated by the pipe symbol |): "text|function":

  lwh.keys.arr =
  [
     ...
     "Hilfe|lwk.send('<PF1>')" , "PF2" ,...
     ...
  ];