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

Draw.writeASCIIText("Hello World!");

Writes "Hello World!" to the screen at the current cursor position and with the currently selected font and attributes.