Multi-Line Text Object (MLTO) is a special Altia built-in object that manages multiple lines of text. It helps users enter multiple lines of text while the design is running.
Among all the built-in animations on MLTO, some are widely used, such as xx_ml_set_line, xx_ml_insert_mode, xx_ml_autowrap_chars, and xx_ml_autowrap_pixels. By sending different values to xx_ml_set_line and xx_ml_insert_mode, we can specify the line insert mode. And if want to auto-fill long text content, we may also need the auto-wrap function. The best way to auto-fill long text content is to send “0” to both xx_ml_set_line and xx_ml_insert_mode, and use either xx_ml_autowrap_chars or xx_ml_autowrap_pixels to calculate the auto-wrapping. The choice between xx_ml_autowrap_chars and xx_ml_autowrap_pixels depends on the actual requirement. The details for the line insert mode settings are as follows:
|
xx_ml_insert_mode |
xx_ml_set_line |
description |
|
non-zero |
0 |
A new line is added at the end of the MLTO and text is put in that line. |
|
non-zero |
n (>0) |
A new line is inserted before line n and text is put in that line. That is, text becomes the new line n and all other lines are shifted down. |
|
0 |
0 |
The text replaces all existing text in the MLTO. How the new text is displayed is still affected by xx_ml_autowrap_pixels and xx_ml_autowrap_chars. |
|
0 |
n (>0) |
The text at line n is replaced by the new text. |