TextBox.AcceptsReturn Propiedad
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property AcceptsReturn As Booleantrue 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.
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
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.
| Producto | Versiones |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |