MDO3000 Programmer Manual.pdf - 第483页
Commands Listed in Alphabetical Order Syntax MESSage:BOX <X 1>,<Y1>[,<X2>,< Y2>] MESSage:BOX? Related Commands MESSage:ST A TE , MESSage:SHOW , MESSage:CLEAR Arguments <X1> and <X2> = …
Commands Listed in Alphabetical Order
Related Commands
MEASUrement:S
TATIstics:MODe
Arguments
<NR1> is the number of samples used for the mean and standard deviation
statistical accumulations.
Examples
MEASUREMENT:STATISTICS:WEIGHTING 4 sets statistical weighting to four
samples.
MEASUREMENT:STATISTICS:WEIGHTING? might return
:MEASUREMENT:STATISTICS:WEIGHTING 4 indicating that
measurement statistics weightingiscurrentlysetto4samples.
MESSage
This command sets or queries message box (screen annotation) parameters.
Group
Display
Syntax
MESSage
MESSage?
Examples
MESSAGE? might return MESSAGE:SHOW "TP401";BOX
271,82,292,114;STATE 0
indicating the message parameters.
MESSage:BOX
This command specifies the co-ordinates of the message box. This command doe
s
not display the message unless MESSage:STATE is on.
X1 and Y1 are the screen coordinates of the top left corner of the message bo
x.
X2 and Y2 are the screen coordinates of the bottom right corner of the message
box. All four coordinates are returned by the query.
Changing the text in the message box, using the MESSAGE:SHOW command,
automatically resizes the message box. If you want a custom message box
size, send the MESSAGE:BOX command after changing the text using the
MESSAGE:SHOW command.
Message box settings and data are saved and restored in saved setups.
Group
Display
2-452 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual
Commands Listed in Alphabetical Order
Syntax
MESSage:BOX <X
1>,<Y1>[,<X2>,<Y2>]
MESSage:BOX?
Related Commands
MESSage:STATE
,
MESSage:SHOW,
MESSage:CLEAR
Arguments
<X1> and <X2> = 0 to 1023, and are pixel positions along the horizontal axis.
<X1> defines the left and <X2> defines the right side of the window.
<Y1> and <Y2> = 0 to 767, and are pixel positions along the vertical axis. <Y1>
defines the top and <Y2> defines the bottom of the window. The reserved height
of all characters is 16 pixels so the window must be at least that high to fully
display cha
racters.
<X2> an d <Y2> are optional because the MESSAGE:SHOW
command automatically sizes the box to fit the message. All four values are
returned in a query.
MESSage:
CLEAR (No Query Form)
Clears the contents of the message box.
Group
Display
Syntax
MESSage:CLEAR
Related Commands
MESSage:B
OX, MESSage:SHOW, MESSage:STATE
Examples
MESSage:CLEAR
removes the message from the message window.
MESSage:SHOW
This command specifies the contents of the message box. MESSage:SHOW
<Qstring> defines the content of the message box. Change in string length causes
automatic resize of the message box to fit the text. The box may be resized using
the MESSage:BOX command. The MESSage:STATE commandisusedtoturn
on and off the message box display.
Group
Display
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-453
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