Onscreen Keyboard Reference

The frame.ttkeyboard file to edit must be in the user's Documents\TinyTERM folder. A sample file is available in the C:\Program Files (x86)\Century\TinyTERM folder.

The file may be edited with any UTF-8 text editor. All lines in the file must end in a line feed or a carriage return/line feed pair. All settings are case-sensitive.




Identifiers

These settings identify specific keyboard layouts and set off comments.

  Setting   Description
+ Name layout and begin section. Also ends previous layout if one is present.
+Database Shortcuts
# Comment line. These can be inserted anywhere in the .ttkeyboard file.
# Accounting layout



General Settings

These settings can be placed anywhere in the .ttkeyboard file, preceded with a dash. They will affect all lines below them, until a new instance of the setting is found.

  Setting   Description
fontSize Maximum font size in points of main key labels.
-fontSize 30
keyboardHeight Height of onscreen keyboard in pixels.
-keyboardHeight 50
keyHeight Changes the default height of the keys, relative to a base value of 1. keyHeight can be specified to the second decimal place, as in the example below. It cannot be set to a specific number of pixels. Default key height in pixels is calculated instead, based on the number of key rows, the spacing and margin settings, and individual keys not using the default keyHeight value.
-keyHeight 1.44
lineJustification Sets the justification for rows of keys:
0 center (default)
1 left justify
2 right justify
-lineJustify 1
margin Minimum number of free pixels on each edge – top, bottom, left and right – of the keyboard.
-margin 3
size Changes the default width of keys, relative to a base value of 1. size can be specified to the second decimal place. It cannot be set to a specific number of pixels. Default key size in pixels is calculated instead, based on the number of keys in the widest row, the spacing and margin settings, iPad orientation, and any individual keys not using the default size value.
-size 1.5
spacing Minimum number of pixels between keys
-spacing 2

Key Options

When a key is defined within square brackets [ ], options may be added to the definition, set off by two semicolons. Many of the general settings can also be applied to individual keys, and so are repeated below with key-specific examples. Options are all case-sensitive.

When a semicolon is desired as a displayed character inside the brackets, such as at the end of a key label, use the octal value \073:

[\073;;size=0.5]
  Option   Description
\ Escape character. Used for special characters that have other uses without the \. Square brackets are not required for this option.
\\
blank When set to 1, prevents the key from being drawn. Used for creating space between visible keys in addition to that specified by the spacing attribute. Blank keys are treated as any others by general attributes.
[BLANK;;blank=1]
fontSize Sets the font size for the primary label of the key.
[Clear;;keyChar=1148;;fontSize=15]
keyChar Assigns a specific value to a key. Available values are listed below.
[Enter;;keyChar=13]
keyHeight Changes the height of the individual key, relative to a base value of 1. keyHeight can be specified to the second decimal place. Keys taller than the default for the row expand into the next row down. When making single a key taller than 1, free the space in the row below by creating a key there with the blank option.
[New Line;;keyHeight=2;;keyChar=1153]
keyString Assigns a multi-character string to a key. This allows you to create custom key mappings with multi-byte sequences on a single keystroke.
[Login;;keyString=username]
size Changes the width of the individual key, relative to a base value of 1. size can be specified to the second decimal place.
[Q;;size=1.45]



Special Characters

The following characters are created with the escape character \.

  Character   Value   Character   Value
\b backspace (hex 08) \\ backslash (hex 5c)
\[ left square bracket (hex 5b) \] right square bracket (hex 5d)
\r carriage return (hex 0d) \x hexadecimal ASCII value; e.g., \x0d for carriage return
\t horizontal tab (hex 09) \0 octal constant; e.g., \011 for horizontal tab

Special characters may be used in combination with the keyString option to create complex sequences:

[PartNum;;keyString=015-249\tsku015249\x0d]



UNIX/Linux keyChar Values

The following values may be assigned to keys used by UNIX/Linux terminal emulations, using the keyChar option.

  Value   Keyboard Key   Value   Keyboard Key
0-255 Equivalent ASCII character1 61747 Ctrl-Page Down
63236-63255 Function keys F1-F20 61748 Ctrl-⌫
63232 Up ↑ 61749 Ctrl-Enter
63233 Down ↓ 61750 Ctrl-Esc
63235 Right → 61751 Ctrl-Keypad -
63234 Left ← 61752 Ctrl-Keypad +
63273 Home 61753 Ctrl-Keypad *
61721-61730 Numeric Keypad 0-9 61754 Keypad *
61731 Keypad - 61755 Keypad +
617322 Keypad , 61756 Keypad /
61733 Keypad . 61757 Num Lock
61734 Keypad Enter 61758 Scroll Lock
61735 Page Down 61759
61736 Page Up 91760 Ctrl-↑
61737 Ctrl-Home 91761 Ctrl-↓
63275 End 61762 Ctrl-Insert
61739 Ctrl-End 61763 Ctrl-Delete
61740 Insert 61766 Ctrl-Tab
61741 Delete 61767 Ctrl-Keypad /
61742 Ctrl-→ 61768 Ctrl-Keypad Enter
61743 Ctrl-← 61769-61788 Shift-F1 to Shift-F20
61744 Print Screen 61789-61708 Ctrl-F1 to Ctrl-F202
61745 Shift-Tab 61809-61828 Alt-F1 to Alt-F20
61746 Ctrl-Page Up 61829-61848 Ctrl-Shift-F1 to Ctrl-Shift-F20

1ASCII values are interpreted through the currently selected code page.

2Ctrl-F5 (key value 353) is also used for the VT220/VT320 Help key. Ctrl-F6 (key value 354) is also used for the VT220/VT320 Do key.




TN3270/TN5250 keyChar Values

The following values may be assigned to keys used by TN3270 or TN5250 emulations.

  Value   Keyboard Key   Value   Keyboard Key
0-255 Equivalent ASCII character1 62599 Field +
8 Backspace ⌫ 62600 Field -
9 Tab 62587 Back Tab
13 Enter (CR) 62601 Field Exit
63232 Up ↑ 62602 Field Mark
63233 Down ↓ 62603 Dup
63235 Right → 62604 Master Reset
63234 Left ← 62605 Cent Sign
63273 Home 62606 Erase
61740 Insert 62607 Erase Field
61741 Delete 62609 Enter Rec
62584-62586 PA1 to PA3 62610 Auto
62588 Clear 62611 Edge Trigger
62589 Erase Input 62612 Roll Up
62590 Erase End of Field 62613 Roll Down
62591 Attn 62614 Reset
62592 Redisplay Screen 62615 Error Reset
62593 New Line 62616 Record Backspace
62597 Sys Req 62617 Last Field Position
62598 Cur Sel

1As with the \x and \0 special characters, ASCII values used with keyChar are converted to EBCDIC during communication with the mainframe.


Back to TinyTERM Plus for Windows documentation index