Esta documentación está archivada y no tiene mantenimiento.

TextBox (Clase)

Representa un control de cuadro de texto de Windows.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class TextBox : TextBoxBase
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class TextBox extends TextBoxBase
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class TextBox extends TextBoxBase
No aplicable.

Con el control TextBox, el usuario puede escribir texto en una aplicación. Este control tiene funcionalidad adicional que no se encuentra en el control de cuadro de texto de Windows estándar, como el enmascaramiento de caracteres de contraseña y la edición de múltiples líneas.

Habitualmente, se utiliza un control TextBox para mostrar, o aceptar como entrada, una sola línea de texto. Es posible utilizar las propiedades Multiline y ScrollBars para permitir que se muestren o escriban varias líneas de texto. Establezca las propiedades AcceptsTab y AcceptsReturn en true con el fin de permitir una mayor manipulación de texto en un control TextBox multilínea.

Para limitar la cantidad de texto escrito en un control TextBox, establezca la propiedad MaxLength en un número de caracteres específico. Los controles TextBox se pueden utilizar también para aceptar contraseñas y otra información delicada. Es posible utilizar la propiedad PasswordChar para enmascarar caracteres escritos en una versión de una sola línea del control. Utilice la propiedad CharacterCasing para permitir al usuario escribir sólo mayúsculas, sólo minúsculas o una combinación de caracteres en mayúsculas y minúsculas en el control TextBox.

Para restringir que se escriba texto en un control TextBox, se puede crear un controlador de eventos para el evento KeyDown con el fin de validar cada carácter escrito en el control. También se puede restringir toda entrada de datos en un control TextBox; para ello, establezca la propiedad ReadOnly en true.

NotaNota:

La mayor parte de la funcionalidad del control TextBox se hereda de la clase TextBoxBase.

NotaNota:

El uso del control TextBox con los estilos visuales habilitados provocará la manipulación incorrecta de las fuentes suplentes.

Nota de la plataforma Windows Mobile 2003 para Pocket PC, Windows Mobile 2003 para Smartphone, Windows CE: En aplicaciones de Pocket PC, las tabulaciones en un cuadro de texto de una sola línea se muestran como paréntesis, pero se muestran con normalidad si Multiline se establece en true.

En el siguiente ejemplo de código se crea un control TextBox multilínea con barras de desplazamiento verticales. En este ejemplo se utilizan las propiedades AcceptsTab, AcceptsReturn y WordWrap para hacer que el control de cuadro de texto multilínea sea útil para crear documentos de texto.

private 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!";
 }
 

private 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 to be entered 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!");
} //CreateMyMultilineTextBox

private function CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control
    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!";
 }
 

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: