Keithley 2601B Reference Manual page 212

Series 2600B System SourceMeter® Instrument Reference Manual
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 is displayed. If Test2
is selected, the message Running Test2 is 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 that you can use 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 to its previous state. The display.prompt()
function creates a new edit screen and does not use the user screen.
Each of these two functions can be used in four ways:
display.inputvalue(format)
display.inputvalue(format, default)
display.inputvalue(format, default, min)
display.inputvalue(format, default, min, max)
display.prompt(format, units, help)
display.prompt(format, units, help, default)
display.prompt(format, units, help, default, min)
display.prompt(format, units, help, default, min, max)
Where:
format
default
min
max
units
help
2600BS-901-01 Rev. B / May 2013
String that creates an editable input field on the user screen at the present cursor position
(examples: +0.00 00, +00, 0.00000E+0)
Value field:
+ = Include for positive/negative value entry; omitting the + prevents negative value entry
0 = Defines the digit positions for the value (up to six zeros (0))
Exponent field (optional):
E = include for exponent entry
+ = Include for positive/negative exponent entry; omitting the + prevents negative value entry
0 = Defines the digit positions for the exponent
Option to set a default value for the parameter, which will be displayed when the command is
sent
Option to specify minimum limits for the input field
•
When NOT using the "+" sign for the value field, the minimum limit cannot
be set to less than zero
•
When using the "+" sign, the minimum limit can be set to less than zero
(for example, -2)
Option to specify maximum limits for the input field
Text string to identify the units for the value (8 characters maximum), for example:
Units text is "V" for volts and "A" for amperes
Informational text string to display on the bottom line (32 characters maximum).
Section 3: Functions and features
3-77