SetCursor (ScreenField subroutine)

Set or return the value of a screenfield (ScreenField class)

The SetCursor method positions the cursor at the beginning of the referenced ScreenField object. An optional numeric argument positions the cursor within the field.

Syntax

sfield:SetCursor[( [position])]

Syntax terms

%sfield	A reference to an instance of a ScreenField object.
position	A positive integral value that specifies the relative position within the %sfield object, where position 1 is the first position in the field and the maximum width was set by the AddField method.

Usage notes

• If the position exceeds the maximum width of the field, the request is canceled.

Examples

1. The following sequence sets the cursor on an unprotected screenfield immediately to the right of a field with a protected ===> command prompt:

   ... %scr is object screen %prompt is object screenField %cmd is object screenField %prompt = %scr:addField(row=2, color=white, - value='===>')

See also

Screen class ScreenField class	List of Screen methods List of ScreenField methods List of Screen API methods	Screen methods syntax ScreenField methods syntax
Notation conventions for methods