ArborX


*

Longname: *   Open the Documentation Legend
Released: not available 
Created: not available 
Last modified: 4.00c 
See also: knames tkl tks wmnx

Summary
Assigns one or more macros to a key or key combination. The * macro can also be used in a simpler way; with a menu shown on screen, and an option highlighted, you can simply press the  *  key to assign that option to a key combination which you will be prompted to enter.
Example extract

The macro below assigns a sequence of macros to 'fake' a titling font to the  A  +  T  key combination:

 *1020 tot .0065h:tw .96h:toc white:tlsb -.01w

Syntax (SVNNA)
char code:n The 3B2 key code of the key or key combination to be used. For most keys this is automatically inserted by 3B2 immediately if you type the key combination after the *. For the letter keys and some other keys on the keyboard you must insert the key's ASCII value yourself. When you try to program one of these keys its numeric code will not be automatically inserted, e.g. if you try to program the  A  key you will get:
Example

The ASCII value for 'A' is 65, so you should change this to:

 *A 3
 *65 5
macro string:b Any macro, or sequence of macros, that you wish to be executed when the key or key combination defined by char code is used.
Example

The macros assigned to a key can be as simple or as complicated as you like, although they should not be longer than 255 characters. Although you cannot include script conditions on a key assignment, ^ macros can be used, allowing you to produce key assignments such as the one shown below. This uses getvar to get the number of pages currently shown on-screen by tpagexy, and then makes the  R  key go down by that number of pages:

 *1081 (wdb "Ac","Dn"):(tpagexy):(^Ac*^Dn):(tpgoto+<^Ac^)
Example

Several similar uses of variables are used in the key assignments built into startdos.3ad. The  V  +  F1  assignment even includes a redefinition of  F1  itself, so that the user can press  V  +  F1  to mark the current location in the text, and later on press  F1  to go back to that point:

 *1094 getvar 11520 "StrmA":getvar 21522 "PosA":(*1059 (ttop "^StrmA" ^PosA):(ttrack)^)
Version specific information6.03a  In conjunction with the wmnx macro you can assign 3B2 or user defined menus to the right mouse button other than the default settings.

Document created on 08-Feb-2003 (revision 1)