CALCLANGUAGE()
 To Change the Calculator Language (ENGLISH/SPANISH/GERMAN)
------------------------------------------------------------------------------

 Syntax

      CALCLANGUAGE( <cNewLanguage> )  -> cOldLanguage

 Arguments

      <cNewLanguage> is a character value representing the language
      for the calculator to begin using whenever the next screens popup.

      NOTE: Only the first three letters of the passed parameter are
      used.

      Currently, the only valid values are:

          "ENG" (English)
      and "SPA" (Spanish)
      and "GER" (German)

 Returns

      CALCREG() returns the current language (either ENGLISH or SPANISH or
       GERMAN)

 Description

      Use CALCLANGUAGE() to set the language of the calculator for the
      help screen, printer messages, error messages, and other necessary
      keywords for complete calculator use.

      You can change the language at any time during use of the calculator.
      The messages *ALREADY ON-SCREEN* will not change. You need to cause
      the calculator to redisplay or exit and reenter.  For this reason,
      we suggest changing languages prior to calling the calculator.

 Advanced Notes

      If you wish to change the language *WHILE* using the calculator,
      there is a right way and wrong way to do it...

      The wrong way:

          SetKey(K_ALT_S, {|| CalcLanguage("SPA") })
          SetKey(K_ALT_E, {|| CalcLanguage("ENG") })
          SetKey(K_ALT_G, {|| CalcLanguage("GER") })

          This will fail because the function CalcLanguage() returns the
          'old' result meaning that it will return the character value
          of "SPANISH" or "ENGLISH".  Since the function was called from
          within the calculator... it will try to 'keyboard' the result
          into the calculator causing problems.

      The right way:

          SetKey(K_ALT_S, {|| CalcLanguage("SPA"),"" })
          SetKey(K_ALT_E, {|| CalcLanguage("ENG"),"" })
          SetKey(K_ALT_G, {|| CalcLanguage("GER"),"" })

          This will return a null string for the calculator to ignore.

 Examples

      CalcReg(12345)            //register your calculator

      CALCLANGUAGE( "SPANISH" ) //choose Spanish

      Calculator()              //call the calculator (or hotkey it)

 Files: CALC.LIB

 Author: Touchstone Business Creations          CompuServe ID: 73670,2561
         28613 River Glen Ct. #1
         Menifee, CA 92584-8987 USA

         (909) 679-3364

 Owner : (c) Copyright, 1991,92,93 Touchstone Business Creations