ToolsCustomizeKeyboard

Syntax

ToolsCustomizeKeyboard [.KeyCode = number] [, .KeyCode2 = number] [, .Category = number] [, .Name = text] [, .Add] [, .Remove] [, .ResetAll] [, .CommandValue = text] [, .Context = number]

Remarks

Assigns and reassigns shortcut keys to built-in commands, macros, fonts, AutoText entries, styles, or common symbols. The arguments for the ToolsCustomizeKeyboard statement correspond to the options on the Keyboard tab in the Customize dialog box (Tools menu).

Argument	Explanation

.KeyCode	A number representing the key combination, as listed later in this entry.
.KeyCode2	A number representing the second key combination in a key sequence. For example, to assign the key sequence CTRL+S, 1 (on the Macintosh, COMMAND+S, 1) to the Heading 1 style, you set .KeyCode to 339 (for CTRL+S or COMMAND+S) and .KeyCode2 to 49 (for 1).
.Category	Specifies the kind of item to assign a shortcut key: 1 or omitted Built-in commands 2 Macros 3 Fonts 4 AutoText entries 5 Styles 6 Common symbols

Argument	Explanation

.Name	The name of the command, macro, or other item. If .Category is set to 6, you can specify a symbol by typing or pasting it into the macro-editing window or using a Chr$() instruction such as Chr$(167).
.Add	Adds the key assignment or assignments to the specified item.
.Remove	If the specified key code is currently assigned, removes the assignment such that the associated key combination has no effect. If the specified key code is not assigned, .Remove resets the key code to its default action. Note that specifying .Name is not required when removing or resetting a key assignment.
.ResetAll	Resets all key assignments to their defaults.
.CommandValue	Additional text required for the command specified by .Name, if any. For example, if .Name is set to Color, .CommandValue specifies the color. For more information, see the table of settings for .CommandValue in ToolsCustomizeMenus.
.Context	Determines where new key assignments are stored: 0 (zero) or omitted Normal template 1 Active template

The following tables list the values you need to specify the appropriate number for .KeyCode. The first table contains values you add to values in the second table when specifying a key combination (for example, you would specify CTRL+S (on the Macintosh, COMMAND+S) as the sum of 256 and 83, or 339).

Add this	To combine with this key

256	CTRL (Windows) or COMMAND (Macintosh)
512	SHIFT
1024	ALT (Windows) or OPTION (Macintosh)
2048	CONTROL (Macintosh)

In Windows, function keys F11 through F16 are equivalent to Alt+F1 through Alt+F6. Therefore, the key code corresponding to F11 has the same effect as a key code corresponding to Alt+F1. Similarly, specifying Alt+F11 — effectively Alt+Alt+F1 — is no different from specifying alt+F1.

This key code	Corresponds to

8	BACKSPACE
9	TAB
12	5 on the numeric keypad when Num Lock is off
13	ENTER
19	Pause

This key code	Corresponds to

27	ESC
32	SPACEBAR
33	PAGE UP
34	PAGE DOWN
35	END
36	HOME
45	INS
46	DEL
48	0
49	1
50	2
51	3
52	4
53	5
54	6
55	7
56	8
57	9
65	A
66	B
67	C
68	D
69	E
70	F
71	G
72	H
73	I
74	J
75	K
76	L
77	M
78	N
79	O
80	P

This key code	Corresponds to

81	Q
82	R
83	S
84	T
85	U
86	V
87	W
88	X
89	Y
90	Z
96	0 on the numeric keypad
97	1 on the numeric keypad
98	2 on the numeric keypad
99	3 on the numeric keypad
100	4 on the numeric keypad
101	5 on the numeric keypad
102	6 on the numeric keypad
103	7 on the numeric keypad
104	8 on the numeric keypad
105	9 on the numeric keypad
106	* on the numeric keypad
107	+ on the numeric keypad
109	– on the numeric keypad
110	. on the numeric keypad
111	/ on the numeric keypad
112	F1
113	F2
114	F3
115	F4
116	F5
117	F6
118	F7
119	F8
120	F9

This key code	Corresponds to

121	F10
122	F11
123	F12
124	F13
125	F14
126	F15
127	F16
145	Scroll Lock
186	;
187	=
188	,
189	-
190	.
191	/
192	`
219	[
220	\
221	]
222	'

Examples

This example assigns CTRL+SHIFT+F (Windows) or command+SHIFT+F (Macintosh) to FileFind:

ToolsCustomizeKeyboard .Category = 1, .Name = "FileFind", \
    .KeyCode = 838, .Add

The following example removes the key assignment from FileFind:

ToolsCustomizeKeyboard .Category = 1, .Name = "FileFind", \
    .KeyCode = 838, .Remove

See Also

CountKeys(), KeyCode(), KeyMacro$()