-MTEXT (Command)

Creates a multiline text object.

The following prompts are displayed.

First, opposite corner

As you click with the pointing device to specify one corner followed by the diagonal corner, a rectangle is displayed to show the location and size of the multiline text object. Arrows within the rectangle indicate the direction of the paragraph's text flow.

Height
Specifies the text height to use for multiline text characters.
  • Height. This prompt is displayed only if the current text style is not annotative.
  • Paper text height. This prompt is displayed only if the current text style is annotative.

The default height, if nonzero, is the height of the current style; otherwise, it is the height stored in the TEXTSIZE system variable. Character height is calculated in drawing units. Changing the height updates the value stored in TEXTSIZE.

Justify
Determines both text justification and text flow, for new or selected text, in relation to the text boundary. The current justification is applied to new text. The text is justified within the specified rectangle based on the justification setting and one of nine justification points on the rectangle. The justification point is based on the first point used to specify the rectangle. Text is center-, left-, or right-justified with respect to the left and right text boundaries. Spaces entered at the end of a line are included as part of the text and affect the justification of the line. Text flow controls whether text is aligned from the middle, the top, or the bottom of the paragraph with respect to the top and bottom text boundaries.
Justification Options Description
TL Top Left
TC Top Center
TR Top Right
ML Middle Left
MC Middle Center
MR Middle Right
BL Bottom Left
BC Bottom Center
BR Bottom Right

The following illustrations show each justification option.

Line spacing
Specifies line spacing for the multiline text object. Line spacing is the vertical distance between the bottom (or baseline) of one line of text and the bottom of the next line of text.
Note: Exact spacing is recommended when you use MTEXT to create a table. Use a smaller text height than the specified line spacing to ensure that text does not overlap.
  • At least. Adjusts lines of text automatically based on the height of the largest character in the line. When At Least is selected, lines of text with taller characters have added space between lines.
  • Distance. Sets the line spacing to an absolute value measured in drawing units. Valid values must be between 0.0833 (0.25x) and 1.3333 (4x).
  • Exactly. Forces the line spacing to be the same for all lines of text in the multiline text object. Spacing is based on the text height of the object or text style.
  • Spacing factor. Sets the line spacing to a multiple of single-line spacing.
Single spacing is 1.66 times the height of the text characters. You can enter a spacing factor as a number followed by x to indicate a multiple of single spacing. For example, specify single spacing by entering 1x, or specify double spacing by entering 2x.
Rotation
Specifies the rotation angle of the text boundary.
  • Rotation angle. If you use the pointing device to specify a point, the rotation angle is determined by the angle between the X axis and the line defined by the most recently entered point (default 0,0,0) and the specified point.

The previous prompt is redisplayed until you specify the opposite corner of the text boundary.

Style
Specifies the text style to use for multiline text.
  • Style name. Specifies a text style name. Text styles can be defined and saved using the STYLE command.
  • ?—List styles. Lists text style names and characteristics.

The previous prompt is redisplayed until you specify the opposite corner of the text boundary.

Width
Specifies the width of the text boundary.

If you use the pointing device to specify a point, the width is calculated as the distance between the start point and the specified point. Words within each line of the multiline text object wrap to fit the width of the text boundary. If you specify a width of 0, word wrap is turned off and the width of the multiline text object is as wide as the longest line of text. You can end a line of text at a specific point by typing the text and pressing Enter. To end the command, press Enter at the MTEXT prompt.

Columns
Specifies the column options for a multiline text object.
  • Static. Specifies the total column width, the number of columns, the gutter width (the space between the columns), and the height of columns.
  • Dynamic. Specifies column width, gutter width and column height. Dynamic columns are text driven. Adjusting columns affect text flow and text flow causes columns to be added or removed.
  • No columns. Sets no column mode to current multiline object.

The default column setting is stored in the MTEXTCOLUMN system variable.