Models 707B and 708B Switching Matrix Reference Manual
Section 7: Command reference
707B-901-01 Rev. A / August 2010
7-73
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
Function Yes
Usage
display.inputvalue(format)
display.inputvalue(format, default)
display.inputvalue(format, default, minimum)
display.inputvalue(format, default, minimum, maximum)
format
A string that defines how the input field is formatted. See
Details
for more information.
default
The default value for the input value.
minimum
The minimum input value.
maximum
The maximum input value.
Details
format
uses 0s, the decimal point, polarity sign, and exponents to define how the input field is formatted.
format
can include the options shown in the following table.
format
options
Option Description
Examples
E
Include the E to display the value exponentially
0.0
+
Allows operators to enter positive or negative values. If the "+"
sign is not included, the operator cannot enter a negative value.
+0.00
0
Defines the digit positions for the value. You can use up to six 0s. +00.0000e+00
.
Include to have a decimal point appear in the value.
+0.00
default
is the value shown when the value is first displayed.
minimum
and
maximum
can be used to limit the values that can be entered. When + is selected for
format
, the
minimum limit must be more than or equal to zero. When limits are used, the operator cannot enter values above
or below these limits.
After the instrument is turned on, the first time you use a display command to write to the display, the message
"USER SCREEN" is cleared. After the first write, you need to use
display.clear()
to clear the message.
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 the operator enters a value and presses the
ENTER
key.
For positive and negative entry ("+" sign used for the value field and/or the exponent field), polarity of a non-zero
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 value or exponent (for example, +00) is always positive and cannot be toggled to negative polarity.
After sending this command and pressing the
EXIT (LOCAL)
key, value returns
nil
.
