Commands Listed in Alphabetical Order
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. (See page A-1, Character Set.)The maximum length of the
message is 1000 characters; the instrument ignores longer strings.
The message box size is set to fit the message. You can also set the message area
height and width using the MESSage:BOX command. The length of the message
that fits 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 returnedasa
query response regardless of what is displayed in the message box.
The message is left-justified, and is displayed on a single line starting with the
topmostlineinthewindow.Anewlinecharactercanbeembeddedinthestring
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 fit within
the message box is truncated. Defining 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 significant eight bits followed by significant eight bits of a
16-bit number. The number specifies the position relative to the left marginof
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
279, then 279 = 0x0117; split the hexadecimal number into two characters 0x01
and 0x17 and send \x09\x01\x17.
Special characters which control decoration are two character sequences where the
first character is an escape (0x1b) and the second character is as described below.
2-454 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual