Compartilhar via

Visão geral de TextBox

  • Artigo

A TextBox classe permite que você exiba ou edite texto não formatado. Um uso comum de um é editar texto não formatado em um TextBox formulário. Por exemplo, um formulário solicitando o nome do usuário, número de telefone, etc. usaria TextBox controles para entrada de texto. Este tópico apresenta a TextBox classe e fornece exemplos de como usá-la em XAML (Extensible Application Markup Language) e C#.

TextBox ou RichTextBox?

Ambos TextBox e RichTextBox permitem que os usuários insiram texto, mas os dois controles são usados para cenários diferentes. A TextBox requer menos recursos do sistema do que um por isso é ideal quando apenas texto simples precisa ser editado (ou seja, uso em um RichTextBox formulário). A RichTextBox é uma escolha melhor quando é necessário que o usuário edite texto formatado, imagens, tabelas ou outro conteúdo com suporte. Por exemplo, editar um documento, artigo ou blog que requer formatação, imagens, etc é melhor realizado usando um RichTextBoxarquivo . A tabela abaixo resume as principais características do TextBox e RichTextBox.

Control Correção ortográfica em tempo real Menu de contexto Formatando comandos como ToggleBold (Ctr+B) FlowDocument conteúdo como imagens, parágrafos, tabelas, etc.
TextBox Sim Sim Não Não.
RichTextBox Sim Yes Sim (consulte Visão geral de RichTextBox) Sim (consulte Visão geral de RichTextBox)

Observação

Embora TextBox não ofereça suporte à formatação de comandos de edição relacionados como (Ctr+B), muitos comandos básicos são suportados por ambos os controles, como ToggleBoldMoveToLineEnd. Consulte EditingCommands para obter mais informações.

Os recursos suportados por TextBox são abordados nas seções abaixo. Para obter mais informações sobre RichTextBoxo , consulte Visão geral do RichTextBox.

Correção ortográfica em tempo real

Você pode habilitar a verificação ortográfica em tempo real em um TextBox ou RichTextBox. Quando a verificação ortográfica está ativada, uma linha vermelha aparecerá sob as palavras incorretas (veja a figura abaixo).

Textbox with spell-checking

Consulte Habilitar verificação ortográfica em um controle de edição de texto para saber como habilitar a verificação ortográfica.

Menu de contexto

Por padrão, ambos TextBox e RichTextBox têm um menu de contexto que aparece quando um usuário clica com o botão direito do mouse dentro do controle. O menu de contexto permite ao usuário recortar, copiar ou colar (veja a figura abaixo).

TextBox with context menu

Você pode criar seu próprio menu de contexto personalizado para substituir o comportamento padrão. Consulte Usar um menu de contexto personalizado com um TextBox para obter mais informações.

Criando TextBoxes

A TextBox pode ser uma única linha em altura ou incluir várias linhas. Uma única linha TextBox é melhor para inserir pequenas quantidades de texto simples (ou seja, "Nome", "Número de telefone", etc. em um formulário). O exemplo a seguir mostra como criar uma única linha 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>

Você também pode criar um TextBox que permite ao usuário inserir várias linhas de texto. Por exemplo, se o formulário solicitou um esboço biográfico do usuário, convém usar um TextBox que ofereça suporte a várias linhas de texto. O exemplo a seguir mostra como usar XAML (Extensible Application Markup Language) para definir um TextBox controle que se expande automaticamente para acomodar várias linhas de texto.

<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>

Definir o atributo como Wrap faz com que o texto seja quebrado em uma nova linha quando a borda do controle for atingidaTextBox, expandindo automaticamente o TextWrappingTextBox controle para incluir espaço para uma nova linha, se necessário.

Definir o atributo como true faz com que uma nova linha seja inserida quando a tecla RETURN é pressionada, expandindo novamente automaticamente o AcceptsReturnTextBox espaço para incluir uma nova linha, se necessário.

O VerticalScrollBarVisibility atributo adiciona uma barra de rolagem TextBoxao , para que o conteúdo do possa ser rolado se o expandir além do tamanho do TextBox quadro ou da janela que o TextBox encerra.

Para obter mais informações sobre diferentes tarefas associadas ao uso de um TextBox, consulte Tópicos de instruções.

Detectar quando o conteúdo é alterado

Normalmente, o evento deve ser usado para detectar sempre que o TextChanged texto em um TextBox ou RichTextBox muda, em vez de KeyDown como você poderia esperar. Consulte Como detectar quando o texto em um TextBox foi alterado para ver um exemplo.

Confira também