TextBoxBase.Multiline Свойство

Определение

Получает или задает значение, показывающее, является ли данный элемент управления "Многострочным текстовым полем".Gets or sets a value indicating whether this is a multiline text box control.

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.true if the control is a multiline text box control; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере кода для TextBoxсоздания многострочного TextBox элемента управления с вертикальными полосами прокрутки используется производный класс.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. В этом примере также используются AcceptsTabсвойства AcceptsReturn, и WordWrap , чтобы сделать многострочное текстовое поле полезным для создания текстовых документов.This example also uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

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

Комментарии

Многострочное текстовое поле позволяет отображать в элементе управления более одной строки текста.A multiline text box allows you to display more than one line of text in the control. Если свойство имеет trueзначение, текст, указанный в многострочном текстовом поле, переносится на следующую строку в элементе управления. WordWrapIf the WordWrap property is set to true, text entered into the multiline text box is wrapped to the next line in the control. Если свойство имеет falseзначение, текст, указанный в многострочном текстовом поле, будет отображаться на той же строке до тех пор, пока не будет указан символ новой строки. WordWrapIf the WordWrap property is set to false, text entered into the multiline text box control will be displayed on the same line until a newline character is entered.

В качестве символов новой строки можно использовать следующие символы:The following can be used as newline characters:

  • Environment.NewLine

  • Контролчарс. CrLfControlChars.CrLf

  • Вбкрлф (только Visual Basic)vbCrLf (Visual Basic only)

Можно добавить полосы прокрутки в текстовое поле, используя ScrollBars свойство для отображения горизонтальных и (или) вертикальных полос прокрутки.You can add scroll bars to a text box using the ScrollBars property to display horizontal and/or vertical scroll bars. Это позволяет пользователю прокручивать текст, выходящий за пределы размеров элемента управления.This allows the user to scroll through the text that extends beyond the dimensions of the control.

Примечание

Поскольку значение Multiline свойства по умолчанию равно false, размер TextBox по умолчанию в соответствии с размером TextBoxшрифта, даже при изменении размера.Because the default value of the Multiline property is false, the default size of a TextBox will be in accordance with the font size even if you resize the TextBox. Чтобы получить последовательный размер TextBox, Multiline присвойте свойству trueзначение.To get a consistent size for your TextBox, set its Multiline property to true.

Примечание

В операционных системах на японском языке Multiline , если свойство имеет trueзначение, при PasswordChar установке свойства будет отображаться текст пароля, что приведет к ослаблению безопасности системы.On Japanese operating systems, if the Multiline property is set to true, setting the PasswordChar property will display the text of the password, thus compromising system security. Поэтому в операционных системах на японском языке задайте Multiline для false свойства значение, если задано PasswordChar свойство.Therefore, on Japanese operating systems, set the Multiline property to false if you set the PasswordChar property.

Примечание

По умолчанию для всех false производных классов это свойство имеет значение, за исключением RichTextBox элемента управления.This property is set to false by default for all derived classes, with the exception of the RichTextBox control.

Для элемента управления RichTextBox.Multiline свойство влияет на то, будет ли элемент управления автоматически изменять размер, следующим образом: RichTextBoxFor a RichTextBox control, the RichTextBox.Multiline property affects whether or not the control will automatically resize, as follows:

Применяется к

Дополнительно