KSETCAPS()
 Queries/sets the system setting for CAPS LOCK
------------------------------------------------------------------------------
 Syntax

     KSETCAPS([<lNewSwitch>]) --> lOldSwitch

 Argument

     <lNewSwitch>  Designates "CAPS LOCK" as on (.T.) or off (.F.).  The
     default value is the system setting.

 Returns

     KSETCAPS() returns the current setting for CAPS LOCK when no parameter
     is specified; otherwise, it returns the previous setting.

 Description

     KSETCAPS() returns the current system setting for CAPS LOCK.  If the
     <lNewSwitch> is specified, CAPS LOCK is set accordingly.

 Examples

     .  Query the CAPSLOCK function:

        lCaps:= KSETCAPS()

     .  Switch on CAPSLOCK and save the previous status:

        lOldCaps:= KSETCAPS(.T.)