Section 9
:
Instrument Control Library (ICL)
Series 3700 System Switch/Multimeter Reference Manual
9-66
Document Number: 3700S-901-01 Rev. A / August 2007
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, display.setcursor, and display.settext 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 9-54)
display.getcursor
(on page 9-55)
display.gettext
(on page 9-57)
display.settext
(on page 9-66)
Example
Positions cursor on 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.
