Skip to content

Mapping a Keystroke

There are three things you need to do in the Keyboard Setup dialog box to map a keystroke:

  1. Identify a keystroke
  2. Identify one or more commands
  3. Link the keystroke to the command

With the Design Tool's Keyboard Setup dialog box, you can identify either the keystroke or the action first, but the linking process must be the final step. Keyboard settings can be saved to a settings file (.dtool) with other configuration information.

To identify a keystroke

  1. Click any modifier keys (Alt, Ctrl, or Shift) that you want to use in the keystroke.

    This step is optional. You can create keystrokes with no modifier keys (such as F7), with a single modifier key (Ctrl+F7), or with multiple modifier keys (Shift+Ctrl+F7).

  2. Select a primary key.

    This can be any key on the PC keyboard--except an unavailable key. Cyan keys are already mapped. To remap a key, click Remove, and then continue.

    If your keyboard keys on your keyboard do not exactly match the PC keyboard keys shown in the Keyboard Setup dialog box, use your keyboard, instead of the mouse, to select a PC keystroke. That way, you'll be able to see how your keyboard keys correspond to the keys on the Design Tool's graphical PC keyboard. Select a key, click an empty spot anywhere under PC Keyboard, and use your keyboard to press the keys you want. Do not use your mouse to click any keys.


You cannot remap the Windows logo function keys.

Removing a Keystroke's Mapping

  1. Select the keystroke on the PC keyboard in the Keyboard Setup dialog box
  2. Click the Remove button.

The key's mapping is cleared (so that pressing the keystroke has no effect in the Design Tool).

Resetting a Keystroke's Mapping

To reset a keystroke to its default setting:

  1. Identify the keystroke in the Keyboard Setup dialog box.
  2. Click the Default button.


Don't confuse the Default button with the Defaults button (which deletes all keyboard customizations).

This procedure only works for PC keystrokes mapped to an action other than the default action for the keystroke.

Restoring the Default Keyboard Mapping

To restore the default keyboard mapping, click Defaults in the Keyboard Setup dialog box.

All keyboard customizations are removed. For information on the default keyboard mapping for VT and HP terminals, click a mapped cyan/teal PC key and note the corresponding Action in the lower half of the Keyboard Mapping dialog box.

Determining Keyboard Mapping

Shading, color, and key appearance are used in the Keyboard Setup dialog box to show how your keyboard is mapped. Cyan keys are mapped, by default, but their mappings can be changed.

Keys not appearing in cyan are not mapped. (Letter and number keys are not considered mapped because it is unlikely you would want to redefine the mappings for these keys.)

If you want to see how a key on the PC is mapped, click the key to select it; the key is selected. If this PC key is mapped to a terminal key, the corresponding key on the terminal keyboard, below, is also selected. For example, click the F1 key on the PC keyboard. It changes color, as does the F1 key (in 5250 sessions) or the PF1 key (in 3270 sessions) on the terminal keyboard. Click F1 on the PC keyboard again to clear the key.


Num Lock key status affects the mapping: If you click the Num Lock key while the Keyboard Setup dialog box is open, you must exit and return to the dialog box before that change is reflected in the displayed keyboard mapping.

Some keys are mapped to Design Tool commands. For example, click the Caps Lock key on the PC keyboard. The terminal keyboard is replaced by a set of fields.

Caps Lock is mapped to the Design Tool command .Toggle(rc_CapsLockState), which turns capital letters on or off.

Click Caps Lock again to clear it.

If you click a modifier key (Alt, Ctrl, or Shift) on the PC keyboard, the color pattern on the remaining keys changes. For example, try clicking Alt. The keys that turn cyan are mapped to Alt. For example, in 5250 sessions, the F1 and D keys become cyan when you click Alt. This means that Alt+F1 and Alt+D are mapped in the Design Tool's default keyboard mapping.

Keys that appear dimmed when you click Alt, Ctrl, or Shift are currently mapped (in combination with the selected modifier key) and cannot be changed. Typically, these are keystrokes that are defined by Windows. For example:

Keystroke Map to setting
Alt+F4 Close the current window (Windows standard)
Ctrl+Esc Display the Windows task list (Windows standard)
Ctrl+Alt+Del Restart system (DOS standard)

Linking a Keystroke to a Command

Once you have identified a PC keystroke and one or more commands to map it to, click the Map button.