Keithley SourceMeter 2600 Series Reference Manual page 302

12-28 Instrument Control Library
display.gettext
Function Reads the text presently displayed.
Usage There are five ways to use this function:
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
row
column_start
column_end
Note: The range of valid column numbers depends on which row is specified. For
• Sending the command without any parameters returns both lines of the display. The
Remarks
$N
line begins.
• With
the message. With
character code will be returned. See the
character codes.
• 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:
The above output indicates that the message "User Screen" is on the top line. The
bottom line is blank.
2600S-901-01 Rev. A / May 2006
Set to
to include all character codes.
true
Set to
from both rows are read.
Set to starting column for reading text. Default is
Set to ending column for reading text. Default is
(Row 2).
32
Row 1, valid column numbers are 1 to 20. For Row 2, valid column numbers
are 1 to 32.
character code will be included to show where the top line ends and the bottom
set to
embellished
embellished
messages" on
User Screen
Return to
Series 2600 System SourceMeters Reference Manual
to return text as a simple character string. Set to
false
or to select which row to read text. If not included, text
1 2
, all other character codes will be returned along with
true
set to false, only the message and the
display.settext
Section 14.
display.settext
$N
Section 12 topics
.
1
(Row 1) or
20
$N
function for details on the