7: TSP command reference Series 2600B System SourceMeter® Instrument
7-72 2600BS-901-01 Rev. C / August 2016
display.inputvalue()
This function displays a formatted input field on the instrument display that the operator can edit.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
display.inputvalue(format)
display.inputvalue(format, default)
display.inputvalue(format, default, minimum)
display.inputvalue(format, default, minimum, maximum)
A string that defines how the input field is formatted; see Details for more information
The default value for the input value
Details
The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how
the input field is formatted. The format parameter can include the options shown in the following
table.
Option Description Examples
Include the E to display the value exponentially
Allows operators to enter positive or negative values; if the
"+" sign is not included, the operator cannot enter a
0
Defines the digit positions for the value; you can use up to
+00.0000e+00
Include to have a decimal point appear in the value
The default parameter is the value shown when the value is first displayed.
The minimum and maximum parameters can be used to limit the values that can be entered. When +
is not selected for format, the minimum limit must be more than or equal to zero (0). When limits are
used, you cannot enter values above or below these limits.
The input value is limited to ±1e37.
Before calling display.inputvalue(), you should send a message prompt to the operator using
display.prompt(). Make sure to position the cursor where the edit field should appear.
After this command is sent, script execution pauses until you enter a value and press the ENTER key.
For positive and negative entry (plus sign (+) used for the value field and/or the exponent field),
polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign
and turning the navigation wheel
. Polarity will also toggle when using the navigation wheel to
decrease or increase the value or exponent past zero. A zero (0) value or exponent (for example,
+00) is always positive and cannot be toggled to negative polarity.
After executing this command and pressing the EXIT (LOCAL) key, the function returns nil.