User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-106 3700S-901-01 Rev. C / July 2008
display.setcursor()
Function
Sets the position of the cursor.
Usage
There are two ways to use this function:
display.setcursor(row, column)
display.setcursor(row, column, style)
row: Set row number for the cursor (1 or 2).
column: Set the column number for the cursor. For row 1, the column can be set from
1 to 20. For row 2, the column can be set from 1 to 32.
style: Set the cursor style to be invisible (0) or blink (1).
Remarks
Sending this command selects the user screen and then moves the cursor to the
given location.
An out of range parameter for row will set the cursor to row 2. An out of range
parameter for column will set the cursor to column 20 (for row 1) or 32 (for row 2).
An out of range parameter for style (a parameter other than 1 or 0) sets it to 0
(invisible).
A blinking cursor will only be visible when it is positioned over displayed text. It
cannot be seen when positioned over a space character.
The display.clear() (on page 13-93), display.setcursor, and
display.settext() (on page 13-106) functions are overlapped, non-blocking
commands. That is, the script will NOT wait for one of these commands to
complete. These non-blocking functions do not immediately update the display. For
performance considerations, they write to a shadow and will update the display as
soon as processing time becomes available.
Also see
display.clear() (on page 13-93)
display.getcursor() (on page 13-95)
display.gettext() (on page 13-97)
display.settext() (on page 13-106)
Example
Positions cursor in row 2, column 1:
display.setcursor(2, 1)
display.settext()
Function
Displays text on the user screen.
Usage
display.settext("text")
text: Text message string to be displayed.