+---------------------------------+
|            CAPSLOCK             |
+---------------------------------+
CAPSLOCK([<expL>])

-----------------------------------
Returns current state of CapsLock or sets state of CapsLock.
Return value - Logical
-----------------------------------

<expL>
        Turns CapsLock on or off. If <expL> is omitted, the status of the
CapsLock mode is returned without changing the current setting.  The
CAPSLOCK() function always returns the logical value of the CapsLock
setting before the function is executed.

+---------------------------------+
|             Examples            |
+---------------------------------+
In last two examples, equal sign is used to execute CAPSLOCK()  without
returning a value.

oldlock = CAPSLOCK(.T.)  && Set CapsLock on

*** <perform any number of statements> ***

= CAPSLOCK(oldlock)     && Return to original setting

*** or, toggle CapsLock to the opposite value ***
= CAPSLOCK(!CAPSLOCK())

-----------------------------------

See Also:  INSMODE(), NUMLOCK()

-----------------------------------