Public Method getUnicodeTextExtent

static Size getUnicodeTextExtent(String unicodeText)

Throws:

• ILCDException

_INSERT_METHOD_SIGNATURE_HERE_

Parameter	Range	Description
unicodeText	Unicode chars ('/u0001' ... '/uFFFF')	unicode text to measure

this method returns:

Returns	Description
static Size	size of the unicode text

This method returns the extent of a unicode text string according to the current font. The Size return type delivers the height and width values of the unicodeText.

• Any control characters like carriage returns and ANSI sequences are interpreted correctly if ANSI mode is enabled.
• Characters not defined in the current font table are calculated as full width spaces and this is how they are shown on the display.
• If you use a symbol font (refer to Attribute.setSymbolFontEnabled(boolean)) no horizontal or vertical spaces between the characters will be displayed, and the this method calculates its values accordingly.
• If text alignment is on (see Control.setTextAlignment(int, int, int)), the reported height and width values correspond to the setting of the alignment. However, the current cursor position is not taken into account (that means no correction of the right and bottom margin will be made in this case).
• Not supported controller types: DPC3020, DPC2060, DPC10xx

Example

Size textUnicode = Control.getUnicodeTextExtent("Hello World!");

int height = textUnicode.getHeight();

int width  = textUnicode.getWidth();

Alternatively a value can be optained with a single call:

int height = Control.getUnicodeTextExtent("Hello World!").getHeight();

int width  = Control.getUnicodeTextExtent("Hello World!").getWidth();

This response means that the Unicode text "Hello World!" will occupy a space of width = 81 (0x51) pixels, and height = 16 (0x10) pixels with the selected font.

Draw.writeASCIIText(String)
Draw.writeText(String)
Control.getTextExtent(String)
Control.getTextMessageExtent(int)