__SetFunction()
Assign a character string to a function key
- Syntax
-
- __SetFunction( <nFunctionKey>, [<cString>] ) --> NIL
- 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 __SetFunction() or SETKEY() for that function.
- Returns
-
- __SetFunction() always return NIL.
- Description
-
- __SetFunction() assign a character string with a function key, when this function key is pressed, the keyboard is stuffed with this character string. __SetFunction() has the effect of clearing any SETKEY() previously set to the same function number and vice versa.
nFunctionKey | Key to be set |
|
1 .. 12 | F1 .. F12 |
13 .. 20 | Shift-F3 .. Shift-F10 |
21 .. 30 | Ctrl-F1 .. Ctrl-F10 |
31 .. 40 | Alt-F1 .. Alt-F10 |
- SET FUNCTION command is preprocessed into __SetFunction() function during compile time.
Examples
// Set F1 with a string
CLS
__SetFunction( 1, "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
- Files
-
- Library is rtl
- See Also