TextBoxBase.Multiline Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает значение, показывающее, является ли данный элемент управления "Многострочным текстовым полем".

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

Значение свойства

Boolean

Значение true, если элемент управления является многострочным текстовым полем; в противном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода используется TextBoxпроизводный класс для создания многострокового TextBox элемента управления с вертикальными полосами прокрутки. В этом примере также используются AcceptsTabсвойства , AcceptsReturnи 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, текст, введенный в элемент управления многострочного текстового поля, будет отображаться в той же строке, пока не будет введен символ новой строки.

Следующие символы можно использовать в качестве символов новой строки:

• Environment.NewLine

• ControlChars.CrLf

• vbCrLf (только Visual Basic)

Вы можете добавить полосы прокрутки в текстовое поле с помощью ScrollBars свойства для отображения горизонтальных и (или) вертикальных полос прокрутки. Это позволяет пользователю прокручивать текст, выходящий за пределы размеров элемента управления.

Примечание

Так как значение Multiline по умолчанию для свойства — false, размер TextBox по умолчанию будет соответствовать размеру шрифта TextBox, даже если размер . Чтобы получить согласованный размер для , TextBoxприсвойте свойству Multiline значение true.

Примечание

В японских операционных системах, если 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 будет автоматически изменяться.

См. также раздел

• Lines
• WordWrap
• ScrollBars