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

 Boxed multi line message
------------------------------------------------------------------------------

 Syntax

         GT_aMsg([<aMss>], [<lWait>], [<cColour>]) --> NIL

 Arguments:

       <nKVal>       - the inkey() value
       <cChkLetter>  - the letter to check for

 Returns:

       NIL

 Description:

       This function has 3 modes of operation
          1.  if <lWait> is TRUE display the message in a box
              and wait for a keypress.  Restire the screen when
              complete.
          2.  if <lWait> is FALSE or undefined, save the screen
              to a stack, display the message and return
          3.  if both <lWait> and <aMss> are undefined, restore
              the screen from the saved stack.
              The positioning information is optional and if it is left
              out the screen will restore to the postion it was saved.
              If coordinates are passed, they must represent an area
              exactly equal to that of the saved screen and in the same
              proportion otherwise the function will return .F.

 Examples:

       aMsg( { "Line 1 of Message",              ;
               "Line 2 of Message",              ;
               "Last Line of Message" }, TRUE)
  $CAVEATS$
       Assumes every element of the array is a character.
       Gets in trouble if the length of an array element is
       longer than maxcol() - 3

 Source: AMSG.PRG

 Author:  Andy M Leighton