Input Prompting - Keithley 2601 Reference Manual

Series 2600 System SourceMeter® Instruments Reference Manual
NOTE Care must be taken when imbedding character codes in the text
Returning a text message
The
display.gettext
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
character code will be included to show where the top line ends and the bottom line begins. The
character code will be returned even if
With
embellished
message line will be returned along with the message. With
message will be returned.
Sending the command without the
command without the
Column 32 for Row 2).

Input prompting

Display messaging can also be used along with front panel controls to make a user script
interactive. For an interactive script, input prompts are displayed so that the operator can perform
a prescribed action using the front panel controls. While displaying an input prompt, the test will
pause and wait for the operator to perform the prescribed action from the front panel.
Menu
A user-defined menu can be presented on the display. The menu consists of the menu name on
the top line, and a selectable list of menu items on the bottom line. The following function is used
to define a menu:
2600S-901-01 Rev. C / January 2008
string. It is easy to forget that the character following the
the code. For 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 in five ways:
Set to to return text as a simple character string. Set to
false
character codes.
Set to or to select which row to read text from. If not included, text from both rows
1 2
is read.
Set to starting column for reading text.
Set to ending column for reading text.
row
set to , all other character codes that were used in the creation of each
true
column start
argument defaults to the last column (Column 20 for Row 1,
column end
Return to Section Topics
parameter returns both lines of the display. The
is set to
embellished false
embellished
parameter defaults to Column 1. Sending the
Section 14: Display Operations
is part of
$
to include
true
$N
.
set to , only the
false
$N
14-7