SetCursor() - Sets the cursor
 Sets the cursor shape
──────────────────────────────────────────────────────────────────────────────

 Syntax

     SetCursor([[<nCursorType>], [<lInsert>]]) --> nCursor

     or:

     SetCursor([[<idCursorForm>], [<lInsert>]]) --> nCursor

     or:

     SetCursor([[<nTopLine>,<nBottomLine>], [<lInsert>]]) --> nCursor

 Arguments

     <nCursorType> is a standard CA-Clipper cursor value of between 0 and 4.

     <idCursorForm> is a 16-bit integer value representing the cursor.

     <nTopLine> is the top scan line of the new cursor.

     <nBottomLine> is the bottom scan line of the new cursor.

     <lInsert> if .T. the cursor is set to Insert mode or if .F. the cursor
     is set to overstrike mode

 Returns

     SetCursor() returns the current cursor setting as numeric value. A
     return value of betwen 0 and 4 represents a value that may be used by
     CA-Clipper SetCursor() function.

     Any other value represents the cursor value set by specifying <nTopLine>
     and <nBottomLine>.

 Description

     This version of SetCursor() allows you to set the cursor in one of two
     ways:

     1. By the CA-Clipper SetCursor() method - passing a value of between 0
        and 4.

     2. Or by creating your own cursor by specifying the top and bottom lines
        of your cursor using <nTopLine> and <nBottomLine>.


 Examples

     ■  Standard SetCursor usage:

        nNormCursor  :=  SetCursor(.F.)         // Overwrite mode
        nInsCursor   :=  SetCursor(.T.)         // Insert mode
        .
        . during program execution the cursor is changed.
        .
        SetCursor(nNormCursor, .F.)             // Reset cursor
        SetCursor(nInsCursor, .T.)              // Reset cursor

     ■  A User defined cursor:

        SetCursor(10, 13)                       // Cursor as thick
                                                // underscore
 Files:  Library is MRWINDOW.LIB.