Keithley 2601 Reference Manual page 286

Section 12: Instrument Control Library
display.gettext
Function Reads the text presently displayed.
There are five ways to use this function:
Usage
text = display.gettext()
text = display.gettext(embellished)
text = display.gettext(embellished, row)
text = display.gettext(embellished, row, column_start)
text = display.gettext(embellished, row, column_start, column_end)
embellished
character string.
row
column_start
column_end
Note: The range of valid column numbers depends on which row is specified. For Row
1, valid column numbers are 1 to 20. For Row 2, valid column numbers are 1 to 32.
Remarks • Sending the command without any parameters returns both lines of the display. The $N
character code will be included to show where the top line ends and the bottom line
begins.
• With embellished set to true, all other character codes will be returned along with the
message. With embellished set to false, only the message and the $N character code
will be returned. See the
• The display will not be switched to the user screen. Text will be read from the active
screen.
Details See "Displaying text
Also see display.getcursor, display.setcursor,
Example Returns all text in both lines of the display:
text = display.gettext()
print(text)
Output:
User Screen
The above output indicates that the message "User Screen" is on the top line. The bottom
line is blank.
12-26
Set to
false
Set to
Set to
1
not included, text from both rows are read.
Set to starting column for reading text. Default
is .
1
Set to ending column for reading text. Default
is (Row 1) or
20
display.settext function for details on the character codes.
messages" in Section 14.
display.settext
$N
Return to Section Topics
Series 2600 System SourceMeter® Instruments Reference Manual
to return text as a simple
to include all character codes.
true
or to select which row to read text. If
2
(Row 2).
32
2600S-901-01 Rev. C / January 2008