TextBoxBase.Multiline Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, является ли это элемент управления многострочного текстового поля.
public:
virtual property bool Multiline { bool get(); void set(bool value); };
public virtual bool Multiline { get; set; }
member this.Multiline : bool with get, set
Public Overridable Property Multiline As Boolean
Значение свойства
true Значение , если элемент управления является элементом управления многострочного текстового поля; falseв противном случае . Значение по умолчанию — false.
Примеры
В следующем примере кода используется TextBoxпроизводный класс для создания многостроного TextBox элемента управления с вертикальными полосами прокрутки. В этом примере также используются AcceptsTabAcceptsReturnсвойства и WordWrap свойства для создания текстовых документов с несколькими строками.
public:
void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox^ textBox1 = gcnew TextBox;
// Set the Multiline property to true.
textBox1->Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1->ScrollBars = ScrollBars::Vertical;
// Allow the RETURN key in the TextBox control.
textBox1->AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1->AcceptsTab = true;
// Set WordWrap to true to allow text to wrap to the next line.
textBox1->WordWrap = true;
// Set the default text of the control.
textBox1->Text = "Welcome!" + Environment::NewLine + "Second Line";
}
public void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox textBox1 = new TextBox();
// Set the Multiline property to true.
textBox1.Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical;
// Allow the RETURN key in the TextBox control.
textBox1.AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = true;
// Set WordWrap to true to allow text to wrap to the next line.
textBox1.WordWrap = true;
// Set the default text of the control.
textBox1.Text = "Welcome!" + Environment.NewLine + "Second Line";
}
Public Sub CreateMyMultilineTextBox()
' Create an instance of a TextBox control.
Dim textBox1 As New TextBox()
' Set the Multiline property to true.
textBox1.Multiline = True
' Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical
' Allow the RETURN key in the TextBox control.
textBox1.AcceptsReturn = True
' Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = True
' Set WordWrap to true to allow text to wrap to the next line.
textBox1.WordWrap = True
' Set the default text of the control.
textBox1.Text = "Welcome!" & Environment.NewLine & "Second Line"
End Sub
Комментарии
Многострочного текстового поля позволяет отображать несколько строк текста в элементе управления.
WordWrap Если для свойства задано trueзначение, текст, введенный в многострочный текстовый поле, упаковывается в следующую строку в элементе управления.
WordWrap Если для свойства задано falseзначение, текст, введенный в элемент управления многострочного текстового поля, будет отображаться в той же строке, пока не будет введен новый символ строки.
Следующие символы можно использовать в качестве новых символов:
ControlChars.CrLf
vbCrLf (только Visual Basic)
Полосы прокрутки можно добавить в текстовое поле с помощью ScrollBars свойства для отображения горизонтальных и /или вертикальных полос прокрутки. Это позволяет пользователю прокручивать текст, который выходит за рамки измерений элемента управления.
Замечание
Так как значение Multiline свойства по умолчанию равно false, размер TextBox по умолчанию будет соответствовать размеру шрифта, даже если изменить размер TextBox. Чтобы получить согласованный размер для вашего TextBoxобъектаtrue, задайте для свойства значение Multiline .
Замечание
В японских операционных системах, если Multiline для свойства задано trueзначение , параметр PasswordChar свойства отобразит текст пароля, тем самым компрометируя системную безопасность. Поэтому в японских операционных системах задайте Multiline для свойства false значение, если задано PasswordChar свойство.
Замечание
Это свойство устанавливается false по умолчанию для всех производных классов, за исключением RichTextBox элемента управления.
RichTextBox Для элемента управления свойство влияет, будет ли элемент управления автоматически изменять размер элемента управления RichTextBox.Multiline следующим образом:
Если RichTextBox.AutoSize задано
trueзначение и RichTextBox.Multiline заданоtrueзначение , RichTextBox не изменится автоматически.Если RichTextBox.AutoSize задано
trueзначение и RichTextBox.Multiline заданоfalseзначение , RichTextBox автоматически изменится размер.