Como controlar o ponto de inserção em um controle TextBox dos Windows Forms

Quando um controle do Windows Forms TextBox recebe o foco pela primeira vez, a inserção padrão dentro da caixa de texto é à esquerda de qualquer texto existente. O usuário pode mover o ponto de inserção com o teclado ou o mouse. Se a caixa de texto perder e, em seguida, recuperar o foco, o ponto de inserção será onde o usuário a colocou pela última vez.

Em alguns casos, esse comportamento pode ser desconcertante para o usuário. Em um aplicativo de processamento de palavras, o usuário pode esperar que novos caracteres apareçam após qualquer texto existente. Em um aplicativo de entrada de dados, o usuário pode esperar que novos caracteres substituam qualquer entrada existente. As SelectionStart propriedades e as SelectionLength propriedades permitem que você modifique o comportamento para atender à sua finalidade.

Para controlar o ponto de inserção em um controle TextBox

1. Defina a SelectionStart propriedade como um valor apropriado. Zero coloca o ponto de inserção imediatamente à esquerda do primeiro caractere.

2. (Opcional) Defina a SelectionLength propriedade com o comprimento do texto que você deseja selecionar.

   O código abaixo sempre retorna o ponto de inserção para 0. O TextBox1_Enter manipulador de eventos deve estar associado ao controle; para obter mais informações, consulte Criando manipuladores de eventos no Windows Forms.

   Private Sub TextBox1_Enter(ByVal sender As Object, ByVal e As System.EventArgs) Handles TextBox1.Enter
      TextBox1.SelectionStart = 0
      TextBox1.SelectionLength = 0
   End Sub
   

   private void textBox1_Enter(Object sender, System.EventArgs e) {
      textBox1.SelectionStart = 0;
      textBox1.SelectionLength = 0;
   }
   

   private:
      void textBox1_Enter(System::Object ^  sender,
         System::EventArgs ^  e)
      {
         textBox1->SelectionStart = 0;
         textBox1->SelectionLength = 0;
      }
   

Tornando o ponto de inserção visível por padrão

O TextBox ponto de inserção fica visível por padrão em um novo formulário somente se o controle for o TextBox primeiro na ordem de tabulação. Caso contrário, o ponto de inserção será exibido somente se você fornecer o TextBox foco com o teclado ou o mouse.

Para tornar o ponto de inserção da caixa de texto visível por padrão em um novo formulário

• Defina a TextBox propriedade do TabIndex controle como 0.

Consulte também

• TextBox
• Visão geral do controle TextBox
• Como criar uma caixa de texto de senha com o controle TextBox do Windows Forms
• Como criar uma caixa de texto Read-Only
• Como colocar aspas em uma cadeia de caracteres
• Como selecionar texto no controle TextBox dos Windows Forms
• Como exibir várias linhas no controle TextBox dos Windows Forms
• Controle TextBox