text

AutoCAD AutoLISP & Visual LISP

 
text
 
 
 
: text {
   alignment fixed_height fixed_width height 
   is_bold key label value width
}

A text tile displays a text string for titling or informational purposes.

Because most tiles have their own label attribute for titling purposes, you don't always need to use text tiles. But a text tile that you usually keep blank is a useful way to display feedback about user actions, error messages, or warnings.

Alert boxes and error tiles are discussed in Dialog Box Exit Buttons and Error Tiles and DCL Error Handling.

If you intend the message to be static, specify it in the label attribute and don't specify a width or value. If you intend the message to change at run-time, specify it in the value attribute and assign a width long enough to contain any strings that you plan to assign the value. Once the dialog box is laid out, the size of its tiles can't change, so if you use set_tile to assign a string longer than the width, the displayed text is truncated.

label

The displayed text. When a text tile is laid out, its width is the larger of either its width attribute, if that is specified in the DCL, or the width required by its label attribute, if specified. At least one of these attributes must be specified.

value

Like label, the value attribute specifies a string to display in the text tile. However, it has no effect on the tile's layout.