Input Prompting - Keithley 2651A Reference Manual

Section 3: Functions and features

Input prompting

Display messaging can be used along with front panel controls to make a user script interactive. In 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. To define a menu, use the
display.menu(menu, items) function.
Where:
The name of the menu; use a string of up to 20 characters (including spaces)
menu
A string is made up of one or more menu items; each item must be separated by white space
items
When the display.menu() function is sent, script execution will wait for the operator to select one
of the menu items. Rotate the navigation wheel
item. Items that don't fit in the display area will be displayed by rotating the navigation wheel
right. With the cursor on the desired menu item, press the navigation wheel
select it.
Pressing the EXIT (LOCAL) key will not abort the script while the menu is displayed, but it will return
nil. The script can be aborted by calling the exit() function when nil is returned.
The following programming example illustrates how to present the operator with the choice of two
menu items: Test1 or Test2. If Test1 is selected, the message Running Test1 will be displayed. If
Test2 is selected, the message Running Test2 will be displayed.
display.clear()
menu = display.menu("Sample Menu", "Test1 Test2")
if menu == "Test1" then
display.settext("Running Test1")
else
display.settext("Running Test2")
end
Parameter value prompting
There are two functions to create an editable input field on the user screen at the present cursor
position: display.inputvalue() and display.prompt().
The display.inputvalue() function uses the user screen at the present cursor position. Once
the command is finished, it returns the user screen back to its previous state. The
display.prompt() function creates a new edit screen and does not use the user screen.
3-76
Model 2651A High Power System SourceMeter® Instrument Reference Manual
to place the blinking cursor on the desired menu
(or the ENTER key) to
2651A-901-01 Rev. A / March 2011
to the