Template
Function
Name
__SetFunction()
Category
API
Subcategory
Events
Oneliner
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 <cString> 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
Compliance
Harbour use 11 and 12 to represent F11 and F12, while CA-Cl*pper use 11 and 12 to represent Shift-F1 and Shift-F2.
Platforms
All
Files
Library is core
Seealso
Inkey(), SetKey(), __Keyboard(), SET KEY
Pingback: Harbour Internal Functions | Viva Clipper !
Pingback: Harbour Internal Functions | Viva Clipper !
Pingback: Harbour Set Functions | Viva Clipper !
Pingback: Harbour RG Summary | Viva Clipper !