Section 11: TSP command reference
Series 3700A System Switch/Multimeter Reference Manual
11-130
3700AS-901-01 Rev. D/June 2018
Example
key = display.getlastkey()
print(key)
On the front panel, press the
MENU
key and
then send the code shown here. This retrieves
the key code for the last pressed key.
Output:
6.01
Also see
(on page 11-139)
display.gettext()
This function reads the text displayed on the front panel.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
text
= display.gettext()
text
= display.gettext(
embellished
)
text
= display.gettext(
embellished
,
row
)
text
= display.gettext(
embellished
,
row
,
columnStart
)
text
= display.gettext(
embellished
,
row
,
columnStart
,
columnEnd
)
text
The returned value, which contains the text that is presently displayed
embellished
Indicates type of returned text:
false
(simple text);
true
(text with embedded
character codes)
row
Selects the row from which to read the text:
1
(row 1);
2
(row 2). If
row
is not
included, both rows of text are read
columnStart
Selects the first column from which to read text; for row 1, the valid column numbers
are 1 to 20; for row 2, the valid column numbers are 1 to 32; if nothing is selected, 1
is used
columnEnd
Selects the last column from which to read text; for row 1, the valid column numbers
are 1 to 20; for row 2, the valid column numbers are 1 to 32; the default is 20 for row
1, and 32 for row 2
Details
Using the command without any parameters returns both lines of the front-panel display.
The
$N
character code is included in the returned value to show where the top line ends and the
bottom line begins. This is not affected by the value of
embellished
.
When
embellished
is set to
true
, all other character codes are returned along with the message.
When
embellished
is set to
false
, only the message and the
$N
character code is returned. For
information on the embedded character codes, see
(on page 11-141).
The display is not switched to the user screen (the screen set using
display.settext()
). Text is
read from the active screen.