Compartilhar via


Como controlar o ponto de inserção em um controle TextBox 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 é à 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 recuperar o foco, o ponto de inserção será sempre o ponto em que o usuário o colocou por último.

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 o texto existente. Em um aplicativo de entrada de dados, o usuário pode esperar que novos caracteres substituam a entrada existente. As SelectionStart propriedades e SelectionLength permitem que você modifique o comportamento para se adequar ao seu propósito.

Controlar o ponto de inserção em um controle TextBox

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

  2. (Opcional) Defina a SelectionLength propriedade como 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 ser 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 é visível por padrão em um novo formulário somente se o TextBox controle for o primeiro na ordem de tabulação. Caso contrário, o ponto de inserção aparecerá somente se você der o TextBox foco com o teclado ou o mouse.

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

Confira também