Keithley SourceMeter 2600 Series Reference Manual page 454

14-8 Display Operations
If the extra
undefined character code and will be ignored. The message "You owe me" will
instead be displayed.
Returning a text message
The
display.gettext
in five ways:
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
Sending the command without the
The
$N
bottom line begins. The
set to
With
creation of each message line will be returned along with the message. With
embellished
Sending the command without the
1. Sending the command without the
column (Column 20 for Row 1, Column 32 for Row 2).
2600S-901-01 Rev. A / May 2006
character is not included, the
$
NOTE Care must be taken when imbedding character
codes in the text string. It is easy to forget that the
character following the
example, assume you want to display "Hello" on the
top line and "Nate" on the bottom line, and so you
send the following command:
display.settext("Hello$Nate")
The above command displays "Hello" on the top line
and "ate" on the bottom line. The correct syntax for the
command is as follows:
display.settext("Hello$NNate")
function returns the displayed message and can be used
Set to
false
to include character codes.
Set to or
1
from both rows are read.
Set to starting column for reading text.
Set to ending column for reading text.
character code will be included to show where the top line ends and the
$N
.
false
set to
embellished true
set to , only the message will be returned.
false
Return to
Series 2600 System SourceMeters Reference Manual
would be interpreted as an
$8
is part of the code. For
$
to return text as a simple character string. Set to
to select which row to read text from. If not included, text
2
parameter returns both lines of the display.
row
character code will be returned even if
, all other character codes that were used in the
column start
column end
Section 14 topics
embellished
parameter defaults to Column
argument defaults to the last
true
is