Compartilhar via


Visão geral do controle TextBox (Windows Forms)

Caixas de texto dos Windows Forms são usadas para obter entradas do usuário ou para exibir texto. O controle TextBox geralmente é usado para texto editável, embora também possa ser tornado somente leitura. Caixas de texto podem exibir várias linhas, quebrar o texto para o tamanho do controle e adicionar formatação básica. O TextBox controle fornece um único estilo de formato para o texto exibido ou inserido no controle. Para exibir vários tipos de texto formatado, use o RichTextBox controle. 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 Text propriedade. Por padrão, você pode inserir até 2048 caracteres em uma caixa de texto. Se você definir a Multiline propriedade como true, poderá inserir até 32 KB de texto. A Text propriedade 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 em tempo de execução. O conteúdo atual de uma caixa de texto pode ser recuperado em tempo de execução lendo a Text propriedade.

O exemplo de código a seguir define o texto no controle no tempo de execução. O InitializeMyControl procedimento 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.";  
   }  

Confira também