Section 9: TSP command reference Series 2600B System SourceMeter® instrument Reference Manual
9-80 2600BS-901-01 Rev. F/August 2021
display.setcursor()
This function sets the position of the cursor.
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 to
32
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 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.clear()
display.setcursor(1, 8)
display.settext("Hello")
display.setcursor(2, 14)
display.settext("World")
This example displays a message on the 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 9-65)
display.getcursor() (on page 9-67)
display.gettext() (on page 9-69)
display.screen (on page 9-78)
display.settext() (on page 9-81)