Compartilhar via


Visão geral do controle TextBox (Windows Forms)

As caixas de texto do Windows Forms são usadas para obter entrada do usuário ou para exibir texto. O controle TextBox é geralmente usado para texto editável, embora também possa ser definido como apenas leitura. As caixas de texto podem exibir várias linhas, encapsular texto no tamanho do controle e adicionar formatação básica. O controle TextBox fornece um estilo de formato único para texto exibido ou inserido no controle. Para exibir vários tipos de texto formatado, use o controle RichTextBox. Para obter mais informações, consulte Visão geral do controle RichTextBox.

Trabalhando com o controle TextBox

O texto exibido pelo controle está contido na propriedade Text. Por padrão, você pode inserir até 2048 caracteres em uma caixa de texto. Se você definir a propriedade Multiline como true, poderá inserir até 32 KB de texto. A propriedade Text pode ser definida em tempo de design com a janela Propriedades, em tempo de execução no código ou pela entrada do usuário no tempo de execução. O conteúdo atual de uma caixa de texto pode ser recuperado em tempo de execução lendo a propriedade Text.

O exemplo de código a seguir define o texto no controle em tempo de execução. O procedimento InitializeMyControl não será executado automaticamente; ele deve ser chamado.

Private Sub InitializeMyControl()
   ' Put some text into the control first.
   TextBox1.Text = "This is a TextBox control."
End Sub
private void InitializeMyControl() {
   // Put some text into the control first.
   textBox1.Text = "This is a TextBox control.";
}
private:
   void InitializeMyControl()
   {
      // Put some text into the control first.
      textBox1->Text = "This is a TextBox control.";
   }

Consulte também