TextBox.AcceptsReturn Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si, al presionar ENTRAR en un control TextBox multilínea, se crea una nueva línea de texto en el control o se activa el botón predeterminado del formulario.

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

Valor de propiedad

Boolean

true si la tecla ENTRAR crea una nueva línea de texto en una versión multilínea del control; false si la tecla ENTRAR activa el botón predeterminado del formulario. De manera predeterminada, es false.

Ejemplos

En el ejemplo de código siguiente se crea un control de varias líneas TextBox con barras de desplazamiento verticales. En este ejemplo se usan las AcceptsTabpropiedades , AcceptsReturny WordWrap para que el control de cuadro de texto de varias líneas sea útil para crear documentos de texto.

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

Comentarios

Si el valor de esta propiedad es false, el usuario debe presionar CTRL+ENTRAR para crear una nueva línea en un control de varias líneas TextBox . Si no hay ningún botón predeterminado para el formulario, la tecla ENTRAR siempre creará una nueva línea de texto en el control, independientemente del valor de esta propiedad.