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

 C_INSERT()

 DESCRIPTION

 C_INSERT() returns the current status of the keyboard INSERT key
 and can set the key on or off.

 NOTES

 C_INSERT() has no effect on Clipper's insert status during a READ,
 but is helpful if evaluating keystrokes with C_KEYCODE() or
 Clipper's INKEY().

 SYNTAX

 C_INSERT([key_toggle])

 PARAMETERS

 key_toggle (L) indicates whether the key should be set on or off.
 Specify true (.T.) to set the key on, or false (.F.) to set the key
 off.  If key_toggle is not specified, C_INSERT() returns the
 current status.

 RETURNS

 C_INSERT() returns the current status of the INSERT key; true (.T.)
 if the key is on, or false (.F.) if the key is off.

 EXAMPLES

 && Get the current insert key status then set the key on
 m_status = c_insert(.t.)
 ...
 ...
 c_insert(m_status)      && Set the key back to the previous status