[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 SHOWKEY()
 Continuously displays the INSERT and LOCK status
------------------------------------------------------------------------------
 Syntax

     SHOWKEY([<cKey>, [[<nLine>], [<nColumn>], <cTextON>,
        <cTextOFF>, [<cAttrON|nAttrON>],
        [<cAttrOFF|nAttrOFF>]]]) --> cNull

 Arguments

     <cKey>  Designates which key to monitor in the form of a letter
     ("C", "N", "S", or "I").  If <cKey> is the only parameter in SHOWKEY()
      (C, N, S, or I), the respective key monitoring is uninstalled.

     <Line>  Designates the line where the display occurs.

     <nColumn>  Designates the column where the display occurs.

     <cTextON>  Designates text for the active status.  A maximum length
     of 15 characters is allowed.

     <cTextOFF>  Designates text for the inactive status. There is a
     maximum of 15 characters and it must have the same length as <cTextON>.

     <cAttrON|nAttrON>  Designates the color attribute for the active
     status.  The default value is 7/0.

     <cAttrOFF|nAttrOFF>  Designates the color attribute for the inactive
     status.  The default value is the same as in <cAttrON|nAttrON>.

     ()  If you call SHOWKEY() without parameters, it uninstalls.

 Returns

     The SHOWKEY() function always returns a null string.

 Description

     SHOWKEY() is an extremely versatile system that can be used to monitor
     the NUM-LOCK, SCROLL-LOCK, CAPS-LOCK, and INSERT keys.  After it is
     installed, you can display an indicator for each key, the desired screen
     position, and a color attribute (without concerning the CA-Clipper
     program).  You can establish a display for both the active and inactive
     status with individual color attributes.  However, both these strings
     must have the same length.

     Since the system INSERT status is handled separately from the
     CA-Clipper INSERT status, this monitoring can only be implemented from
     within a READ.  An indicator display, in so far as it has been
     activated, is refreshed in intervals of approximately 200 milliseconds.
     Therefore, when you clear a portion or the complete screen, do not
     concern yourself with restoring this display.

 Note

     Warning!  Always uninstall this function before you leave a program
     or use the Extended Drivers provided with this CA-Clipper Tools.  The
     function changes interrupt vectors.  You may cause a system crash, if
     the old status is not restored before you exit the program!  Use the
     enclosed INTSAVE program to avoid this problem.

 Examples

     .  Display "CAPS" if CAPS-LOCK is on: CAPS-LOCK for off: "    ",
        in line 24, column 50.  The default value for on and off is "7/0"

        SHOWKEY("C", 24, 50, "CAPS", "    ")

     .  Attributes can be numeric and or designated as in CA-Clipper:

        SHOWKEY("N", 24, 60, "NUM ON", "NUMOFF", 112, "W/R")

     .  Inverse the display for on and off:

        SHOWKEY("S", 24, 70, "SCRL", "  ", "0/7")

     .  Uninstall the NUM-LOCK display:

        SHOWKEY("N")

     .  Uninstall the function:

        SHOWKEY()


See Also: SHOWTIME()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson