Tektronix DPO4000 Series, Programmer'S Manual

Page: 264 / 623

Commands Listed in Alphabetical Order
MESSage:SHOW
Sets or returns the contents of the message box. MESSage:SHOW <Qstring>
de
fi nes the content of the message box. Change in string length causes automatic
resize of the message box to
fi t the text. The box may be resized using the
MESSage:BOX command. The MESSage:STATE command is used to turn on
and off the message box display.
Group Display
Syntax
MESSage:SHOW <QString>
MESSage:SHOW?
Related Commands MESSage:BOX , MESSage:CLEAR , MESSage:STATE
Arguments
<QString>
is the message and can include any of the characters shown in
the Character Set, Appendix A. The maximum length of the message is 1000
characters; the instrument ignores longer strings.
The message box size is set to fi t the message. You can also set the message area
height and width using the MESSage:BOX command. The length of the message
that fi ts in the message area depends on the contents of the message because
the width of characters varies.
If the message exceeds the limits of the message box, either horizontally or
vertically, the portion of the message that exceeds the limits will not be displayed.
The message string itself is not altered. The entire message can be returned as a
query response regardless of what is displayed in the message box.
The message is left-justi fi ed, and is displayed on a single line starting with the
top most line in the window. A new line character can be embedded in the string
to position the message on multiple lines. You can also use white space and tab
characters to position the message within a line. Text which does not
fi t within
the message box is truncated. De fi ning a message box text string erases any
previously displayed text within the message box.
You can send a tab by transmitting a tab character (\t or \x09) followed characters
representing the most signi
fi cant eight bits followed by signi fi cant eight bits of a
16-bit number. The number speci fi es the position relative to the left margin of
the message area. For example, to tab send TAB (\t or \x09), NUL (decimal 0),
and CR (decimal 13).
For example, using hexadecimal escape sequences, MESSAGE:SHOW
’\x09\x01\x17Hello’ when sent as a command would cause the ’Hello’ to be
displayed starting at pixel position 279 relative to the left margin set by the
MESSAGE:BOX command. If you want to display characters starting at position
2-250 MSO4000 and DPO4000 Series Programmer Manual