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)