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

SETCURSOR()

Syntax:     SETCURSOR([<expN1>][,<expN2>][,<expL>])

Arguments:  <expN1> is the starting line of the new cursor.
            <expN1> is the final line of the new cursor.
            <expL> will indicate whether it is necessary to change
            the cursor for overwriting or inserting.

Returns:    A character string.
            The function will always return a null string.

Usage:      SETCURSOR() can be used to set the cursor form in a
            variety of ways.  <expN1> will apply as the initial line and
            <expN2> as the final line for the cursor display, if they are
            specified.  In the absence of <expN2, <expN1> will be
            considered as a combined value (see also GETCURSOR()).
            The cursor can be returned in the "normal" form by leaving
            out both values.  The cursor will be switched off completely
            if the value -1 is specified for <expL>.  It is also possible to
            specify which cursor to change using <expL>; the one for
            overwriting or the one for inserting.

Note:       SETCURSOR() will store the form for two cursor
            representations: one form for overwriting and one for
            inserting.  The cursor form for overwriting will be changed if
            <expL> is specified false (.F.) or left out, as will the form for
            inserting when (.T.) is specified.  It is only possible to switch
            over between the two forms in GET and memo fields or with
            Clipper's READINSERT().   None of the other input
            commands will allow any insertion mode and hence will not
            allow the cursor form to be switched over either.  It is
            assumed that the insert key in a GET or memo field was
            used to switch over to insert mode.  The field will then be
            left with this status and a different input command (for
            example ACCEPT) will be executed.  The cursor form for
            inserting will then appear in this input command.  For this
            reason is necessary to switch over to overwrite again before
            another input command with READINSERT().  The area for
            the arguments <expN1> and <expN2> will depend on the
            screen adapter used.  The possible values in CGA cards will
            extend from 0 (first line) to 7 (last line).  The value for the
            last line will be increased to 13 for the monochrome graphics
            card with higher resolution.

            The definition of line in this case does not mean the same
            as screen (output) line, but refers to scan or pixel lines
            which compose a symbol on the screen.

            If -1 is given for <expN1>, then the cursor will be switched
            off permanently.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   cursor = GETCURSOR()        && Save the current cursor form
                                        && The cursor is changed

            SETCURSOR(cursor)           && Placed again via the
                                        && combined value

            SETCURSOR(10,13)            && Cursor as thick underline
                                        && on monochrome graphic card