TextBox.AcceptsReturn 屬性

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll
來源:
TextBox.cs
來源:
TextBox.cs
來源:
TextBox.cs
來源:
TextBox.cs
來源:
TextBox.cs

取得或設定一個值，指示在多行 TextBox 控制項中按下 ENTER 是否會產生新文字行，或是啟動表單的預設按鈕。

public:
 property bool AcceptsReturn { bool get(); void set(bool value); };
public bool AcceptsReturn { get; set; }
member this.AcceptsReturn : bool with get, set
Public Property AcceptsReturn As Boolean

屬性值

Boolean

true 若按 ENTER 鍵在多行版本的控制項中建立新一行文字; false 如果 ENTER 鍵啟動了表單的預設按鈕。 預設值為 false。

範例

以下程式碼範例建立一個多行 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 to be entered 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!";
   }

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 to be entered 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!";
 }

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 to be entered 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!"
End Sub

備註

若此屬性值為 false，使用者必須按 CTRL+ENTER 才能在多行 TextBox 控制中建立新行。 如果表單沒有預設按鈕，ENTER鍵總是會在控制項中產生新的文字行，不論該屬性的值是多少。

適用於