12-32
Return to
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 “
Also see
,
,
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:
$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.
$R
Sets text to Normal.
$B
Sets text to Blink.
$D
Sets text to Dim intensity.
$F
Sets 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 “
” in
Also see
,
,
