Section 3: Functions and features
Model 2651A High Power System SourceMeter® Instrument Reference Manual
3-76
2651A-901-01 Rev. A / March 2011
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:
menu
The name of the menu; use a string of up to 20 characters (including spaces)
items
A string is made up of one or more menu items; each item must be separated by white space
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
to place the blinking cursor on the desired menu
item. Items that don’t fit in the display area will be displayed by rotating the navigation wheel
to the
right. With the cursor on the desired menu item, press the navigation wheel
(or the
ENTER
key) to
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.
