Usage Guidelines for the Multi Line Text Object (MLTO)

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.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.