DISPlay:TEXT

From Keysight 34970A/34972A

DISPlay:TEXT

Syntax

DISPlay:TEXT <quoted_string>

DISPlay:TEXT?

Description

This command displays a text message on the instrument's front-panel display. The instrument can display up to 12 characters on the front panel; any additional characters are truncated (no error is generated).

Parameters

Name Type Range of Values Default Value
<quoted_string> Quoted ASCII String A string of up to 12 characters enclosed in quotation marks. You can use letters (A-Z), numbers (0-9), and special characters like "@", "%", "*", and so on. Use "#" character to display a degree symbol ( °). This is a required parameter.

Remarks

  • Commas, periods, colons, 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.
  • 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 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 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 Subsystem Introduction

DISPlay:TEXT:CLEar