Información general sobre TextBoxTextBox Overview

La TextBox clase le permite mostrar o editar texto sin formato.The TextBox class enables you to display or edit unformatted text. Un uso común de es TextBox la edición de texto sin formato en un formulario.A common use of a TextBox is editing unformatted text in a form. Por ejemplo, un formulario que solicita el nombre del usuario, el número de teléfono, etc TextBox . usaría controles para la entrada de texto.For example, a form asking for the user's name, phone number, etc would use TextBox controls for text input. En este tema se TextBox presenta la clase y se proporcionan ejemplos de cómo usarla en C# Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) y.This topic introduces the TextBox class and provides examples of how to use it in both Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) and C#.

¿TextBox o RichTextBox?TextBox or RichTextBox?

Y permiten RichTextBox a los usuarios escribir texto, pero los dos controles se usan para distintos escenarios. TextBoxBoth TextBox and RichTextBox allow users to input text but the two controls are used for different scenarios. Un TextBox requiere menos recursos del sistema RichTextBox y, por tanto, es ideal cuando solo es necesario editar texto sin formato (es decir, el uso en un formulario).A TextBox requires less system resources then a RichTextBox so it is ideal when only plain text needs to be edited (i.e., usage in a form). Una RichTextBox es una opción mejor cuando es necesario que el usuario edite texto con formato, imágenes, tablas u otro contenido compatible.A RichTextBox is a better choice when it is necessary for the user to edit formatted text, images, tables, or other supported content. Por ejemplo, la edición de un documento, artículo o blog que requiera formato, imágenes, etc RichTextBox., se consigue mejor mediante.For example, editing a document, article, or blog that requires formatting, images, etc is best accomplished using a RichTextBox. En la tabla siguiente se resumen las características principales TextBox de TextBoxy.The table below summarizes the primary features of TextBox and TextBox.

ControlControl Revisión ortográfica en tiempo realReal-time Spellchecking Menú contextualContext Menu Comandos de formato ToggleBold como (CTR + B)Formatting commands like ToggleBold (Ctr+B) FlowDocumentcontenido como imágenes, párrafos, tablas, etc.FlowDocument content like images, paragraphs, tables, etc.
TextBox Yes Yes SinNo No.No.
RichTextBox Yes Yes Sí (consulte RichTextBox Overview[Introducción a RichTextBox])Yes (see RichTextBox Overview) Sí (consulte RichTextBox Overview[Introducción a RichTextBox])Yes (see RichTextBox Overview)

Nota

Aunque TextBox no admite el formato de comandos de edición ToggleBold relacionados como (CTR + B), muchos comandos básicos son compatibles MoveToLineEndcon ambos controles, como.Although TextBox does not support formatting related editing commands like ToggleBold (Ctr+B), many basic commands are supported by both controls such as MoveToLineEnd. Vea EditingCommands para obtener más información.See EditingCommands for more information.

Las características admitidas por TextBox se describen en las secciones siguientes.Features supported by TextBox are covered in the sections below. Para obtener más información RichTextBoxsobre, vea información general sobre RichTextBox.For more information about RichTextBox, see RichTextBox Overview.

Revisión ortográfica en tiempo realReal-time Spellchecking

Puede habilitar la revisión ortográfica en tiempo real en TextBox un RichTextBoxo.You can enable real-time spellchecking in a TextBox or RichTextBox. Cuando se activa la revisión ortográfica, aparece una línea roja debajo de las palabras con errores de ortografía (consulte la siguiente imagen).When spellchecking is turned on, a red line appears underneath any misspelled words (see picture below).

Textbox con revisión ortográficaTextbox with spell-checking

Consulte Cómo habilitar el corrector ortográfico en un control de edición de texto para más información sobre cómo activar la revisión ortográfica.See Enable Spell Checking in a Text Editing Control to learn how to enable spellchecking.

Menú contextualContext Menu

De forma predeterminada, TextBox y RichTextBox tienen un menú contextual que aparece cuando un usuario hace clic con el botón secundario dentro del control.By default, both TextBox and RichTextBox have a context menu that appears when a user right-clicks inside the control. El menú contextual permite al usuario cortar, copiar o pegar (consulte la siguiente imagen).The context menu allows the user to cut, copy, or paste (see picture below).

TextBox con menú contextualTextBox with context menu

Puede crear su propio menú contextual personalizado para invalidar el comportamiento predeterminado.You can create your own custom context menu to override the default behavior. Consulte Use a Custom Context Menu with a TextBox (Usar un menú contextual personalizado con TextBox) para más información.See Use a Custom Context Menu with a TextBox for more information.

Crear controles TextBoxCreating TextBoxes

TextBox Puede ser una sola línea de alto o contener varias líneas.A TextBox can be a single line in height or comprise multiple lines. Una sola línea TextBox es mejor para la entrada de pequeñas cantidades de texto sin formato (es decir, el nombre, el número de teléfono, etc. en un formulario).A single line TextBox is best for inputting small amounts of plain text (i.e. "Name", "Phone Number", etc. in a form). En el ejemplo siguiente se muestra cómo crear una sola TextBoxlínea.The following example shows how to create a single line TextBox.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox Width="200" MaxLength="100" />
  </StackPanel>
</Page>

También puede crear un TextBox que permita al usuario escribir varias líneas de texto.You can also create a TextBox that allows the user to enter multiple lines of text. Por ejemplo, si el formulario solicita un boceto biográfico del usuario, querrá usar un TextBox que admita varias líneas de texto.For example, if your form asked for a biographical sketch of the user, you would want to use a TextBox that supports multiple lines of text. En el ejemplo siguiente se muestra cómo Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) utilizar para definir TextBox un control que se expande automáticamente para alojar varias líneas de texto.The following example shows how to use Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) to define a TextBox control that automatically expands to accommodate multiple lines of text.

<TextBox
  Name="tbMultiLine"
  TextWrapping="Wrap"
  AcceptsReturn="True"
  VerticalScrollBarVisibility="Visible"
>
  This TextBox will allow the user to enter multiple lines of text.  When the RETURN key is pressed, 
  or when typed text reaches the edge of the text box, a new line is automatically inserted.
</TextBox>

Si se TextWrapping establece el Wrap atributo en, el texto se ajusta a una nueva línea TextBox cuando se alcanza el borde del control, expandiendo TextBox automáticamente el control para incluir espacio para una nueva línea, si es necesario.Setting the TextWrapping attribute to Wrap causes text to wrap to a new line when the edge of the TextBox control is reached, automatically expanding the TextBox control to include room for a new line, if necessary.

Si se AcceptsReturn establece el true atributo en, se insertará una nueva línea cuando se presione la tecla entrar, se expandirá TextBox de nuevo automáticamente para incluir el espacio para una nueva línea, si es necesario.Setting the AcceptsReturn attribute to true causes a new line to be inserted when the RETURN key is pressed, once again automatically expanding the TextBox to include room for a new line, if necessary.

El VerticalScrollBarVisibility atributo agrega una barra TextBoxde desplazamiento a, de modo TextBox que el contenido de se puede desplazar a través TextBox de si el objeto se expande más allá del tamaño del marco o de la ventana que lo incluye.The VerticalScrollBarVisibility attribute adds a scroll bar to the TextBox, so that the contents of the TextBox can be scrolled through if the TextBox expands beyond the size of the frame or window that encloses it.

Para obtener más información sobre las distintas tareas asociadas al TextBoxuso de, consulte los temas de procedimientos.For more information on different tasks associated with using a TextBox, see How-to Topics.

Detectar los cambios de contenidoDetect When Content Changes

Normalmente, TextChanged el evento se debe usar para detectar siempre que el texto TextBox de RichTextBox un KeyDown o cambie, en lugar de como cabría esperar.Usually the TextChanged event should be used to detect whenever the text in a TextBox or RichTextBox changes, rather then KeyDown as you might expect. Consulte Detectar cuándo cambiad el texto en un control TextBox para ver un ejemplo.See Detect When Text in a TextBox Has Changed for an example.

Vea tambiénSee also