DISPlay:TEXT

34980A

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>

Quoted ASCII 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 ..."

See Also

DISPlay:TEXT:CLEar

SYSTem:LOCK:REQuest?