Method ilcd.Draw.writeASCIIText

Public Method writeASCIIText

static void writeASCIIText(String textString)

Throws:

ILCDException

_INSERT_METHOD_SIGNATURE_HERE_

Parameter	Range	Description
textString	Unicode symbols encoded in UTF8	text to be output

Writes a string to the current cursor position. Note that each byte of the string will be interpreted as ASCII code. The following example demonstrates the difference between this method and Draw.writeText(String).

     // UTF8 code for "∀" is 0xE2 0x88 0x80
     Draw.writeASCIIText("∀");      // prints 3 characters according to the definition in the current font for 0xE2, 0x88 and 0x80.
     Draw.writeText("∀");           // prints "∀" if defined in the current font or SPACE

Note

Characters not defined in the character table of a font are replaced with a space.
If the column address exceeds the right or bottom margin during printing, and the corresponding wrap mode is not set, the following characters are ignored.
Writing text will increase the row or column address and therefore change the cursor position.
To get the horizontal and vertical space occupied by the outputted text use the Control.getUnicodeTextExtent(String) method.
The text can contain any ANSI sequence (see ANSI Support) to e.g. control the cursor position (on a character or graphic based position) when the ANSI mode is on.

Example

Non Unicode Font symbols with codes above 127 can be displayed using a char-array.

     Attribute.setFont("CP1252");

     char[] c = {0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80};
     String str = new String(c);

     // use ASCII Font with codepage CP1252
     Draw.writeASCIIText(str);

This will write "€€€€€€€€€€" to the screen (€ = 0x80 in CP1252).