12-32 Return to Section Topics 2600S-901-01 Rev. C / January 2008
Section 12: Instrument Control Library Series 2600 System SourceMeter® Instruments Reference Manual
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 column number for the cursor. For row 1,
column can be set from 1 to 20. For row 2,
column can be set from 1 to 32.
style Set 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 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.
Details See “Sending keycodes” in Section 14.
Also see display.clear, display.getcursor, display.gettext, display.settext
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.
Remarks • This function selects the user display screen, and displays the given text. The first write
to the display after poweron will clear the user screen.
• The text starts at the present cursor position. After the text is displayed, the cursor will be
located after the last character in the display message.
• Top line text will not wrap to the bottom line of the display automatically. Any text that
does not fit on the current line will be truncated. If the text is truncated, the cursor will be
left at the end of the line.
• The text remains on the display until replaced or cleared.
• The following character codes can be also be included in the text string:
$NNewline – Starts text on the next line. If the cursor is already on line 2, text will be
ignored after the ‘$N’ is received.
$RSets text to Normal.
$B Sets text to Blink.
$DSets text to Dim intensity.
$FSets text to background blink.
$$Escape sequence to display a single “$”.
• 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.
Details See “Displaying text messages” in Section 14.
Also see display.clear, display.getcursor, display.gettext, display.setcursor
To Next Page
Loading...
Need help?
General
