Specifies whether a control can accept and display multiple lines of text.
Syntax
object.MultiLine [= Boolean]
The MultiLine property syntax has these parts:
| Part | Description |
|---|---|
| object | Required. A valid object. |
| Boolean | Optional. Whether the control supports more than one line of text. |
Settings
The settings for Boolean are:
| Value | Description |
|---|---|
| True | The text is displayed across multiple lines (default). |
| False | The text is not displayed across multiple lines. |
Remarks
A multiline TextBox allows absolute line breaks and adjusts its quantity of lines to accommodate the amount of text it holds. If needed, a multiline control can have vertical scroll bars.
A single-line TextBox doesn't allow absolute line breaks and doesn't use vertical scroll bars.
For controls that support the MultiLine property as well as the WordWrap property, WordWrap is ignored when MultiLine is False.
Single-line controls ignore the value of the WordWrap property.
Note If you change MultiLine to False in a multiline TextBox, all the characters in the TextBox will be combined into one line, including non-printing characters (such as carriage returns and new-lines).
The EnterKeyBehavior and MultiLine properties are closely related. The EnterKeyBehavior values of True and False only apply if MultiLine is True. If MultiLine is False, pressing ENTER always moves the focus to the next control in the tab order regardless of the value of EnterKeyBehavior.
The effect of pressing CTRL+ENTER also depends on the value of MultiLine. If MultiLine is True, pressing CTRL+ENTER creates a new line regardless of the value of EnterKeyBehavior. If MultiLine is False, pressing CTRL+ENTER has no effect.
The TabKeyBehavior and MultiLine properties are closely related. The values described above only apply if MultiLine is True. If MultiLine is False, pressing TAB always moves the focus to the next control in the tab order regardless of the value of TabKeyBehavior.
The effect of pressing CTRL+TAB also depends on the value of MultiLine. If MultiLine is True, pressing CTRL+TAB creates a new line regardless of the value of TabKeyBehavior. If MultiLine is False, pressing CTRL+TAB has no effect.