FT_MENUTO()
 Execute light bar menu using prompts created with @...PROMPT
──────────────────────────────────────────────────────────────────────────────

 Syntax

      #include "FTMENUTO.CH"

      MENU TO <var> [COLD]

 Arguments

     <var> is the name of the variable to which the result of the menu
     selection should be assigned.

     [COLD] is optional and if specified indicates that trigger characters
     should be treated as "cold," i.e. rather than causing the menu item
     to be selected it only causes the light bar to move to that selection.

 Description

     This enhanced version of MENU TO requires the inclusion of the header
     file FTMENUTO.CH in any source file that uses it.  It may be used in
     place of the standard Clipper MENU TO command.  However, in the
     interests of functionality it is NOT 100% compatible (in particular,
     you should make sure that the target memvar exists before executing
     the menu -- the Clipper version will create a PRIVATE memvar for you
     if it does not already exist, but this version does not).  No whining!
     If compatibility is such a big deal then use the standard Clipper
     command.

     Note that this command can also be called using function-style
     syntax.  See the entry for FT_MENUTO() for further details.

 Examples

    #include "FTMENUTO.CH"

    // Simple command

    MENU TO memvar

 Header File: FTMENUTO.CH

 Source: MENUTO.PRG

 Author: Ted Means