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:
-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.