SET FUNCTION

Assign a character string to a function key

Syntax

SET FUNCTION <nFunctionKey> TO [<cString>]

Arguments

<nFunctionKey> is a number in the range 1..40 that represent the function key to be assigned.

<cString> is a character string to set. If is not specified, the function key is going to be set to NIL releasing by that any previous Set Function or SETKEY() for that function.

Description

Set Function assign a character string with a function key, when this function key is pressed, the keyboard is stuffed with this character string. Set Function has the effect of clearing any SETKEY() previously set to the same function number and vice versa.

nFunctionKeyKey to be set
1 .. 12F1 .. F12
13 .. 20Shift-F3 .. Shift-F10
21 .. 30Ctrl-F1 .. Ctrl-F10
31 .. 40Alt-F1 .. Alt-F10

SET FUNCTION command is preprocessed into __SetFunction() function during compile time.

Examples

// Set F1 with a string
CLS
Set Function 1 to "I Am Lazy" + CHR( 13 )
cTest := SPACE( 20 )
@ 10, 0 SAY "type something or F1 for lazy mode " GET cTest
READ
? cTest

Status

Ready

Compliance

Harbour use 11 and 12 to represent F11 and F12, while CA-Clipper use 11 and 12 to represent Shift-F1 and Shift-F2.

Platforms

All

See Also