Keithley 3700 series Reference Manual page 203

Series 3700 System Switch/Multimeter Reference Manual
display.inputvalue
Function
Usage
Remarks
Document Number: 3700S-901-01 Rev. A / August 2007
Displays a formatted input field that the operator can edit.
There are four ways to use this function:
value = display.inputvalue(format)
value = display.inputvalue(format, default)
value = display.inputvalue(format, default, min)
value = display.inputvalue(format, default, min, max)
format: Define format string for the input field using `0's, the decimal point (.), polarity
sign (+) and 'E' for exponent.
default: Set the default value for the parameter.
min: Set the minimum input value that can be set.
max: Set the maximum input value that can be set.

This function will make use of text to create an editable input field on the user
screen at the present cursor position. The first write to the display after power-on
will clear the user screen.
Examples of the input field:

+0.00 00 +00.0000E+00

0.00000E+0
Value field:

+ Include a plus sign for positive/negative value entry. Do not include the "+" sign to
prevents negative value entry.

0 Defines the digit positions for the value. Up to six 0's can be used for the value
(as shown above in the third and fourth examples).

. If used, include the decimal point (.) where needed for the value.
Exponent field (optional):

E Include the "E" for exponent entry.

+ Include a plus sign for positive/negative exponent entry. If a "+" sign is not
included, negative exponent entry is prohibited.

0 Defines the digit positions for the exponent.

You can also specify minimum and maximum 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 set to less than zero (for
example, -2).

There is also an option to specify a default value. When this command is executed,
the initially displayed value for the field will be the default value.

Message prompts to instruct the operator should be displayed prior to calling this
function. Make sure to position the cursor where the edit field should appear.

The input value is limited to ±1e37.
Section 9: Instrument Control Library (ICL)
9-59