Series 3700A System Switch/Multimeter Reference Manual
Section 11: TSP command reference
3700AS-901-01 Rev. D/June 2018
11-137
display.prompt()
This function prompts the user to enter a parameter from the front panel of the instrument.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
display.prompt("
format
", "
units
", "
help
")
display.prompt("
format
", "
units
", "
help
",
default
)
display.prompt("
format
", "
units
", "
help
",
default
,
minimum
)
display.prompt("
format
", "
units
", "
help
",
default
,
minimum
,
maximum
)
format
A string that defines how the input field is formatted; see
Details
for more information
units
Set the units text string for the top line (eight characters maximum); this indicates the units (for
example, "V" or "A") for the value
help
Text string to display on the bottom line (32 characters maximum)
default
The value that is shown when the value is first displayed
minimum
The minimum input value that can be entered
maximum
The maximum input value that can be entered (must be more than minimum)
Details
This function creates an editable input field at the present cursor position, and an input prompt
message on the bottom line. Example of a displayed input field and prompt:
0.00V
Input 0 to +2V
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
E
Include the E to display the value exponentially. Include a
plus sign (+) for positive/negative exponent entry. Do not
include the plus sign (+) to prevent negative value entry. 0
defines the digit positions for the exponent.
0.0
+
Allows operators to enter positive or negative values. If
the plus 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 zeros (0).
+00.0000E+00
.
The decimal point where needed for the value.
+0.00
You can use the
minimum
and
maximum
parameters to limit the values that can be entered. When a
plus sign (+) is not selected for
format
, the minimum limit must be greater than or equal to zero (0).
When limits are used, the operator cannot enter values above or below these limits.
The input value is limited to ±1e37.
After sending this command, script execution pauses for the operator to enter a value and press
ENTER
.
