Jetter AG
Control of alphanumeric HMIs | 3
Application-oriented manual – Control of alphanumeric HMIs (LCD) and printers
23
3.5.2 DisplayText2() STX command
Declaration
Function
DisplayText2(Dev:Int,
Pos:Int,
Const Ref
Text1:String)
Const Ref
Text2:String);
Parameter
Parameter
Value
Description
Dev
0 ... 4
Number of the HMI where the text string
is to be output
Pos
1 ... number of char-
acters on the screen
Cursor position defining the starting
point for a text string to be displayed
Text1
Text string to be
displayed
Hard-coded text, or name of a string
variable
Text2
Text string to be
displayed
Hard-coded text, or name of a string
variable
Tab. 13:
DisplayText2()
parameter
How to use this
command
Command-line syntax for displaying one of two text strings:
DisplayText2(
0
,
25
,
'Fehler:'
,
'Error:'
);
Operating principle
Calling up the STX command makes the text strings 'Fehler:' or 'Error:' appear on
the default device (Dev = 0) from cursor position 25 onwards. MR 2806 controls
which text string will be displayed.
3.5.3 Clearing the screen
If text strings are displayed, there are two control characters allowing to clear the
screen content:
■
Clearing the entire screen content
■
Clearing the text string to the end of the line
INFO
Limitations
If display commands are addressed to devices 8 ... 11, these
characters are not considered as control characters but dis-
played as text.
Clearing the screen
The default character for clearing the screen is the underline character ‘_’.
Using this character first deletes the displayed text strings, and then outputs any
text following the underline character from cursor position 1 onwards.
Example
DisplayText(
0
,
10
,
'H_ello'
);
Result: The screen is cleared and the word fragment "ello" appears from cursor
position 1 onwards.