DISPlay:TEXT
Syntax
DISPlay:TEXT "<string>"
DISPlay:TEXT?
Description
This command displays a text message on the upper line of the instrument's front-panel display. The instrument can display up to 18 characters on the front panel; any additional characters are truncated (no error is generated).
Parameters
Name |
Type |
Range of Values |
Default Value |
<string> |
A string of up to 18 characters enclosed in quotes.
You can use letters (A-Z), numbers (0-9), and special characters like
"@", "%", "*", etc. Use "#" character
to display a degree symbol ( |
This is a required parameter |
Remarks
Commas, periods, and semicolons share a display space with the preceding character, and are not considered individual characters.
While a message is displayed on the front panel, readings from a scan or monitor are not sent to the front-panel display.
Sending a text message to the display overrides the display state (see DISPlay:STATe command); this means that you can display a message even if the display is turned off.
Pressing any front-panel key will clear the text message. To prevent this, use the SYSTem:LOCK:REQuest? command.
The display text is not stored as part of the instrument state by the *SAV command.
The front-panel display is automatically cleared when power is cycled, after a Factory Reset (*RST command), or after an Instrument Preset (SYSTem:PRESet command).
Return Format
The query command reads the message currently displayed on the front panel and returns an ASCII string enclosed in double quotes. If no message is displayed, a null string ( " " ) is returned.
Examples
The following commands display a message on the upper line of the front panel (the quotes are not displayed).
DISP:TEXT "SCANNING ..." or DISP:TEXT 'SCANNING ...'
The following query returns the message currently displayed on the front panel (the quotes are also returned).
DISP:TEXT?
Typical Response: "SCANNING ..."