Click above to get retro games delivered to your door ever month!

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.

      +--------------------------------------+
      | 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
      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