beautypg.com

Display:text[:set – RIGOL DG1000Z Series User Manual

Page 39

background image

Chapter 2 Command System

RIGOL

DG1000Z Programming Guide

2-27

:DISPlay:TEXT[:SET]

Syntax

:DISPlay:TEXT[:SET] [,x[,y]]

Description

Display the specified string from the specified coordinate on the screen.

Parameter

Name

Type

Range

Default

ASCII string

Refer to the

“Explanation”

None

x

Integer

2 to 319

2

y

Integer

2 to 239

2

Explanation

is a string enclosed in double quotation marks (note that the

double quotation marks at the outermost of the string are not displayed on the

screen), for example, ”RIGOL”. The specified string can contain up to 45

characters and the command is invalid when the specified string exceeds 45

characters. The specified string will be truncated when it cannot be displayed in

a single row.

 The x and y in [,x[,y]] denotes the coordinate setting values of the X axis (the

horizontal axis) and Y axis (the vertical axis) respectively (the coordinate values

set are the coordinate values of the upper-left corner of the string displayed on

the screen). When only one coordinate value is specified, the instrument treated

it as the horizontal axis value (x) by default. When the parameters are omitted,

the instrument displays the specified string from the last effective coordinate (if

no coordinate has been set after power-on, the default coordinate will be used).

 You can send the

:DISPlay:TEXT?

command to query the string currently

displayed on the screen or send the

:DISPlay:TEXT:CLEar

command to clear the

string currently displayed on the screen.

Return Format

The query returns a string enclosed in double quotation marks and the content in the

double quotation marks is the content currently displayed on the screen (the double

quotation marks at the outermost of the string are not displayed on the screen), for

example, ”RIGOL”.

Example

:DISP:TEXT "RIGOL",25,35 /*Display the string RIGOL from (25,35) on the

screen*/

Related

Commands

:DISPlay:TEXT?
:DISPlay:TEXT:CLEar