Key Maps

This topic lists control keys and actions in three separate formats. The first list is arranged in alphabetical order by keystroke. The second list is arranged in CTLVAL order. The third list is arranged by keystroke grouped by specific values.

Alphabetical Key Listing

Default Key	CTL VAL	Action	Notes
^E	32,71	Insert Character	Edit
^V	54	Version Display	Input
^W	39,75	Clear to EOL	Edit
BACKSPACE (^H)	34,68	Backspace	Edit
CR/ENTER	0	Carriage Return
DELETE (^X)	33,72	Delete Character	Edit
DOWN (^J)	5,9,67	Down
END (^Z)	17,77	End	Edit
ESCAPE	41,69	Restore Value	Edit
F1 (^G-1)	-1,63	Help	Input
F2 (^G-2)	6	Cancel
F3 (^G)	51	Gold Key	Input
F3-^W (^G-^W)	40	Clear to EOS
F3-A (^G-A)	46	Append Record
F3-B (^G-B)	28	Blink
F3-C (^G-C)	24	Center Line
F3-D (^G-D)	38,79	Delete Line
F3-DELETE (^G-^X)	45	Delete Record
F3-ESCAPE (^G-ESCAPE)	42,82	Reprint
F3-F (^G-F)	27	Foreground (Bold)
F3-F1 (^G-^G-1)	49	Record Macro
F3-F2 (^G-^G-2)	50	Play Macro
F3-I (^G-I)	37,78	Insert Line
F3-INSERT (^G-^T)	44	Insert Record
F3-L (^G-L)	26	Line Draw
F3-LEFT (^G-^H)	18,84	Previous Word
F3-P (^G-P)	22	Paste
F3-PAGE DOWN (^G-^F)	13	Next Screen
F3-PAGE UP (^G-^B)	12	Previous Screen
F3-R (^G-R)	29	Reverse
F3-RIGHT (^G-^L)	19,83	Next Word
F3-T (^G-T)	21	Cut
F3-TAB (^G-^I)	36,74	Back Tab	Edit
F3-U (^G-U)	30	Underline
F3-W (^G-W)	31	Wrap
F4 (^G-4)	2	Execute
F5 (^G-5)	7	Search
F6 (^G-6)	52	Hotkey Menu	Input
F7 (^G-7)	43	Update Record
F8 (^G-8)	20	Jump
F9 (^G-9)	23	Block
F10 (^G-0)	53	Toggle
HOME (^A)	16,76	Home	Edit
INSERT (^T)	25,70	Insert	Edit
LEFT (^H)	14,64	Left	Edit
MOUSE CLICK	48	Mouse Click
PAGE DOWN (^F)	4,11,80	Page Down
PAGE UP (^B)	3,10,81	Page Up
RIGHT (^L)	15,65	Right	Edit
TAB (^I)	35,73	Tab	Edit
Terminal Dependent*	55	App1
Terminal Dependent*	56	App2
Terminal Dependent*	58	App3
Terminal Dependent*	58	App4
Terminal Dependent*	59	App5
Terminal Dependent*	60	App6
Terminal Dependent*	61	App7
Terminal Dependent*	62	App8
UP (^K)		1,8,66	Up

Numerical Listing

CTL VAL	Default Key	Action	Notes
-1,63	F1 (^G-1)	Help	Input
0	CR/ENTER	Carriage Return
1,8,66	UP (^K)	Up
2	F4 (^G-4)	Execute
3,10,81	PAGE UP (^B)	Page Up
4,11,80	PAGE DOWN(^F)	Page Down
5,9,67	DOWN (^J)	Down
6	F2 (^G-2)	Cancel
7	F5 (^G-5)	Search
12	F3-PAGE UP (^G-^B)	Previous Screen
13	F3-PAGE DOWN (^G-^F)	Next Screen
14,64	LEFT (^H)	Left	Edit
15,65	RIGHT (^L)	Right	Edit
16,76	HOME (^A)	Home	Edit
17,77	END (^Z)	End	Edit
18,84	F3-LEFT (^G-^H)	Previous Word
19,83	F3-RIGHT (^G-^L)	Next Word
20	F8 (^G-8)	Jump
21	F3-T (^G-T)	Cut
22	F3-P (^G-P)	Paste
23	F9 (^G-9)	Block
24	F3-C (^G-C)	Center Line
25,70	INSERT (^T)	Insert	Edit
26	F3-L (^G-L)	Line Draw
27	F3-F (^G-F)	Foreground (Bold)
28	F3-B (^G-B)	Blink
29	F3-R (^G-R)	Reverse
30	F3-U (^G-U)	Underline
31	F3-W (^G-W)	Wrap
32,71	^E	Insert Character	Edit
33,72	DELETE (^X)	Delete Character	Edit
34,68	BACKSPACE (^H)	Backspace	Edit
35,73	TAB (^I)	Tab	Edit
36,74	F3-TAB (^G-^I)	Back Tab	Edit
37,78	F3-I (^G-I)	Insert Line
38,79	F3-D (^G-D)	Delete Line
39,75	^W	Clear to EOL	Edit
40	F3-^W (^G-^W)	Clear to EOS
41,69	ESCAPE	Restore Value	Edit
42,82	F3-ESCAPE (^G-ESCAPE)	Reprint
43	F7 (^G-7)	Update Record
44	F3-INSERT (^G-^T)	Insert Record
45	F3-DELETE (^G-^X)	Delete Record
46	F3-A (^G-A)	Append Record
47	RESERVED
48	MOUSE CLICK	Mouse Click
49	F3-F1 (^G-^G-1)	Record Macro
50	F3-F2 (^G-^G-2)	Play Macro
51	F3 (^G)	Gold Key	Input
52	F6 (^G-6)	Hotkey Menu	Input
53	F10 (^G-0)	Toggle
54	^V	Version Display	Input
55	Terminal Dependent*	App1
56	Terminal Dependent*	App2
57	Terminal Dependent*	App3
58	Terminal Dependent*	App4
59	Terminal Dependent*	App5
60	Terminal Dependent*	App6
61	Terminal Dependent*	App7
62	Terminal Dependent*	App8

Overview

The following lists present the same keys as the above listings, only grouped by specific purposes. The information is identical to previous lists.

Action Key Values

Action	Default Key	CTL VAL
Cancel	F2 (^G-2)	6
CR/ENTER	CR	0
Execute	F4 (^G-4)	2
First Field	PAGE UP (^B)	3
Last Field	PAGE DOWN (^F)	4
Next Field	DOWN (^J)	5
Prev Field	UP (^K)	1
Search	F5 (^G-5)	7

Movement Key Values

Action	Default Key	CTL VAL	Notes
Down	DOWN (^J)	9,67
End	END (^Z)	17,77	Edit
Home	HOME (^A)	16,76	Edit
Jump	F8 (-8)	20
Left	LEFT (^H)	14,64	Edit
Next Screen	F3-PAGE DOWN (^G-^F)	13
Next Word	F3-RIGHT (^G-^L)	19,83
Page Down	PAGE DOWN (^F)	11,80
Page Up	PAGE UP (^B)	10,81
Previous Screen	F3-PAGE UP (^G-^B)	12
Previous Word	F3-LEFT (^G-^H)	18,84
Right	RIGHT (^L)	15,65	Edit
Up	UP (^K)	8,66

Block Key Values

Action	Default Key	CTL VAL
Block	F9 (^G-9)	23
Center Line	F3-C (^G-C)	24
Cut	F3-T (-T)	21
Paste	F3-P (-P)	22

Toggle Key Values

Action	Default Key	CTL VAL	Notes
Blink	F3-B (^G-B)	28
Foreground (Bold)	F3-F (^G-F)	27
Insert	INSERT (^T)	25,70	Edit
Line Draw	F3-L (^G-L)	26
Reverse	F3-R (^G-R)	29
Underline	F3-U (^G-U)	30
Wrap	F3-W (^G-W)	31

Edit Key Values

Action	Default Key	CTL VAL	Notes
Backspace	BACKSPACE (^H)	34,68	Edit
Back Tab	F3-TAB (^G-^I)	36,74	Edit
Clear to EOL	^W	39,75	Edit
Clear to EOS	F3-^W (^G-^W)	40
Delete Character	DELETE (^X)	33,72	Edit
Delete Line	F3-D (^G-D)	38,79
Insert Character	^E	32,71	Edit
Insert Line	F3-I (^G-I)	37,78
Tab	TAB (^I)	35,73	Edit

Miscellaneous Key Values

Action	Default Key	CTL VAL	Notes
Append Record	F3-A (^G-A)	46
Delete Record	F3-DELETE (-^X)	45
Gold Key	F3 (^G)	51	Input
Help	F1 (^G-1)	-1,63	Input
Hotkey Menu	F6 (^G-6)	52	Input
Insert Record	F3-INSERT (-)	44
Mouse Click	MOUSE CLICK	48
Play Macro	F3-F2 (^G-^G-2)	50
Record Macro	F3-F1 (^G-^G-1)	49
Reprint	F3-ESCAPE (^G-ESCAPE)	42,82
Restore Value	ESCAPE	41,69	Edit
Toggle	F10 (^G-0)	53
Update Record	F7 (-7)	43
Version Display	^V	54	Input

Application Defined Key Values

Action	Default Key	CTL VAL
App1	Terminal Dependent*	55
App2	Terminal Dependent*	56
App3	Terminal Dependent*	57
App4	Terminal Dependent*	58
App5	Terminal Dependent*	59
App6	Terminal Dependent*	60
App7	Terminal Dependent*	61
App8	Terminal Dependent*	62

*Terminal Dependent: The default will depend on the termcap settings. However, on many terminals, these are usually Shift+F1 through Shift+F8, or F11 and F12 may be used for App1 and App2.

Keys labeled (Edit) in the Key Value tables above are tied to the input routine and never pass a value to an application program.

Input Keys

Keys labeled (Input) cause an action to take place within the input program, as follows:

<HELP> calls online help, based on parameters passed to the input program (See _ninput.utl.)
<GOLDKEY>, also called a META key, is used to extend the set of characters available for mapping. This is always used in combination with another key. <GOLDKEY> is mapped to F3 by default.
<HOTKEY> calls a menu named _hotkey and is shipped with the following options:

Option	Utility Called
(C) Calculator	(BBSTD)_calc
(K) Modify Keymap	(BBEXT)_ekeymap.utl
(L) Display Last Error	(BBEXT)_lwarn.utl
(S) System Command	(BBEXT)_scall.utl
(N) Configuration Editor	_coned.bbx (TAOS Project Manager only)

Edit these options by modifying the _hotkey menu with _msedit.utl.

<VERSION> can be used to display a short message containing the software name and version in a window.

These values are stored internally as:

STBL("#VERSION")=$00$+"Your Application Rev. 1.3"
STBL("!TREG")="BASIS International Ltd.12345"

The information in STBL("!TREG") is ignored if the string table variable is not set.

All other keys, not labeled (Edit) or (Input), pass a CTLVAL value back to the application in the CTLVAL variable. It is up to the application program to interpret this CTLVAL value.

The _lkeymap.utl program makes the key label names available to the application program via global strings. This permits the creation of help prompts such as:

"Press "+STBL("#F2")+" to update or "+STBL("#F6")+" to cancel."

This help prompt, along with the default keymap, is displayed as:

"Press F4 to update or F2 to cancel."

These global string table variables are named as "#F", plus the associated CTLVAL value.