Keithley 2601 Reference Manual page 292

Section 12: Instrument Control Library
display.setcursor
Function Sets the position of the cursor.
There are two ways to use this function:
Usage
display.setcursor(row, column)
display.setcursor(row, column, style)
row
column
style
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,
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
Also see display.clear, display.getcursor, display.gettext,
Positions cursor on row 2 column 1:
Example
display.setcursor(2, 1)
display.settext
Function Displays text on the user screen.
Usage
display.settext(text)
text
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
•
$N Newline – Starts text on the next line. If the cursor is already on line 2, text will be
ignored after the '$N' is received.
Sets text to Normal.
$R
Sets text to Blink.
$B
Sets text to Dim intensity.
$D
Sets text to background blink.
$F
Escape sequence to display a single "$".
$$
• The display.clear, display.setcursor,
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
Also see display.clear, display.getcursor, display.gettext,
12-32
Set
Set
column
column
Set cursor
keycodes" in Section 14.
Text message string to be displayed.
messages" in Section
Return to Section Topics
Series 2600 System SourceMeter® Instruments Reference Manual
number for the cursor (1 or 2).
row
number for the cursor. For row 1,
column
can be set from 1 to 20. For row 2,
can be set from 1 to 32.
to be invisible (0) or blink (1).
style
and
display.settext functions
display.settext
and
display.settext
14.
display.setcursor
string:
text
2600S-901-01 Rev. C / January 2008