HP E8402A, Руководство пользователя и обслуживания, Страница: 59 / 249

Programming the Enhanced Monitor 61
Chapter 3
DISPlay[:WINDow]:TEXT[:DATA] <string>
DISPlay[:WINDow]:TEXT[:DATA] displays a user defined message string on the
mainframe’s display. The message remains on the display until a key is pressed, the
display window is changed programmatically, or the screen saver turns off the
display.
Parameters
Comments
•
Four lines of text can be displayed. The display uses a proportional font; line
length can vary from 25 to 45 characters. The string will be clipped at 45
characters if there is not an embedded ‘\n’, or it will be clipped at 4 lines, or at
186 characters. There is no error generated if the string is clipped. Text is white
letters on a black background.)
•
Embed a ‘\n’ to cause a second, third, or fourth line. For example, the
command
DISP:TEXT “this is a test\nof the immediate
\nmessage capability
.” executed from an RS-232 terminal will create
the following display:
this is a test
of the immediate
message capability.
•
Pressing any front panel key (up/down arrow keys or
ENTER
key) or
executing a
DISP:WIND
command will remove the text.
Error Conditions
The following table lists the most common error conditions and causes. Error
numbers and corresponding messages can be found using
SYSTem:ERRor? query.
Reset Condition
*RST removes text, and set the display screen to MMAin.
Example
The following is a Visual C example:
viPrintf(vi, “disp:text \”this is a test\nof the immediate\nmessage capability.\”\n”)
Name Type Range Default Description
< string> string 186 characters none Message to display on screen. Can be any
ASCII character (decimal value 20 to 225).
Number Message Probable Cause
-128 “Numeric data not allowed” The <string> started with a number.
-148 “Character data not allowed” Quotation marks were left off.
-151 “Invalid string data” An embedded new line in the string
instead of a ‘\n’.
-221 “Settings Conflict” The mainframe’s power is off.