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请将 PasswordChar 属性设置为 false 。

注意

默认情况下，对于所有派生类，此属性设置为 false ，控件除外 RichTextBox 。

RichTextBox对于控件， RichTextBox.Multiline 属性会影响控件是否会自动调整大小，如下所示：

• 如果 RichTextBox.AutoSize 设置为 true 且 RichTextBox.Multiline 设置为 true， RichTextBox 则 不会自动调整大小。

• 如果 RichTextBox.AutoSize 设置为 true 且 RichTextBox.Multiline 设置为 false， RichTextBox 则 将自动调整大小。

另请参阅

• Lines
• WordWrap
• ScrollBars