System SourceMeter® Instrument Reference Manual Section 7:
2600BS-901-01 Rev. B / May 2013 7-75
display.setcursor()
This function sets the position of the cursor.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
display.setcursor(row, column)
display.setcursor(row, column, style)
The row number for the cursor (1 or 2)
The active column position to set; row 1 has columns 1 to 20, row 2 has columns 1
Set the cursor to invisible (0, default) or blinking (1)
Details
Sending this command selects the user screen and then moves the cursor to the given location.
The display.clear(), display.setcursor(), and display.settext() functions are overlapped
commands. That is, the script does not wait for one of these commands to complete. These functions do not
immediately update the display. For performance considerations, they update the physical display as soon as
processing time becomes available.
An out-of-range parameter for row sets the cursor to row 2. An out-of-range parameter for column sets the
cursor to column 20 for row 1, or 32 for row 2.
An out-of-range parameter for style sets it to 0 (invisible).
A blinking cursor is only visible when it is positioned over displayed text. It cannot be seen when positioned over
a space character.
Example
display.setcursor(1, 8)
display.settext("Hello")
display.setcursor(2, 14)
display.settext("World")
This example displays a message on the
instrument front panel, approximately center.
Note that the top line of text is larger than the
bottom line of text.
The front panel of the instrument displays "Hello"
on the top line and "World" on the second line.
Also see
display.clear() (on page 7-60)
display.getcursor() (on page 7-62)
display.gettext() (on page 7-64)
display.screen (on page 7-73)
display.settext() (on page 7-76)