Partilhar via


Como: Controlar o ponto de inserção em um controle de caixa de texto do 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 fica à 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 estará 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 texto, 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 propriedades SelectionStart e SelectionLength permitem que você modifique o comportamento para se adequar à sua finalidade.

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

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

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

    O código abaixo sempre retorna o ponto de inserção para 0. O manipulador de eventos TextBox1_Enter deve estar vinculado 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 ponto de inserção TextBox é visível por padrão em um novo formulário somente se o controle TextBox for o primeiro na ordem de tabulação. Caso contrário, o ponto de inserção aparecerá somente se você der ao TextBox o 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

Ver também