TextBoxBase.Multiline 属性

  • 项目

获取或设置一个值，该值指示它是否为多行文本框控件。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
<LocalizableAttribute(True)> _
Public Overridable Property Multiline As Boolean
用法
Dim instance As TextBoxBase
Dim value As Boolean

value = instance.Multiline

instance.Multiline = value

[LocalizableAttribute(true)] 
public virtual bool Multiline { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property bool Multiline {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Multiline ()

/** @property */
public void set_Multiline (boolean value)

public function get Multiline () : boolean

public function set Multiline (value : boolean)

属性值

如果该控件是多行文本框控件，则为 true；否则为 false。默认为 false。

备注

多行文本框使您可以在控件中显示多行文本。如果将 WordWrap 属性设置为 true，则在多行文本框中输入的文本将在控件中换到下一行。如果将 WordWrap 属性设置为 false，则在多行文本框控件中输入的文本将显示在同一行上，直到输入换行符才换行。

以下字符可以用做换行符：

可以使用 ScrollBars 属性向文本框添加滚动条，以显示水平和/或垂直滚动条。这使用户可以滚动超出了控件尺寸范围的文本。

提示

因为 Multiline 属性的默认值为 false，所以即使调整 TextBox 的大小，TextBox 的默认大小也会与字体大小相同。若要为 TextBox 获取相同的大小，请将它的 Multiline 属性设置为 true。

提示

在日文操作系统中，如果 Multiline 属性设置为 true，设置 PasswordChar 属性将显示密码的文本，从而危及系统安全性。因此，在日文操作系统中，如果设置了 PasswordChar 属性，请将 Multiline 属性设置为 false。

提示

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

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

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

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

示例

下面的代码示例使用派生类 TextBox 来创建一个带垂直滚动条的多行 TextBox 控件。此示例还使用 AcceptsTab、AcceptsReturn 和 WordWrap 属性来使多行文本框控件可用于创建文本文档。

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

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:
   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.set_Multiline(true);
    // Add vertical scroll bars to the TextBox control.
    textBox1.set_ScrollBars(ScrollBars.Vertical);
    // Allow the RETURN key in the TextBox control.
    textBox1.set_AcceptsReturn(true);
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.set_AcceptsTab(true);
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.set_WordWrap(true);
    // Set the default text of the control.
    textBox1.set_Text("Welcome!" + Environment.get_NewLine()
        + "Second Line");
} //CreateMyMultilineTextBox

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

TextBoxBase 类
TextBoxBase 成员
System.Windows.Forms 命名空间
TextBoxBase.Lines 属性
WordWrap
TextBox.ScrollBars 属性