Control.GotFocus Evento

Definição

Ocorre quando o controlo recebe o foco.

public:
 event EventHandler ^ GotFocus;
[System.ComponentModel.Browsable(false)]
public event EventHandler GotFocus;
[<System.ComponentModel.Browsable(false)>]
member this.GotFocus : EventHandler 
Public Custom Event GotFocus As EventHandler 

Tipo de Evento

Atributos

Exemplos

O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do GotFocus evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância de um tipo que herda de Control, como um Button ou ComboBox. Depois, nomeie a instância Control1 e assegure que o gestor de eventos está associado ao GotFocus evento.

private void Control1_GotFocus(Object sender, EventArgs e) {

   MessageBox.Show("You are in the Control.GotFocus event.");
}
Private Sub Control1_GotFocus(sender as Object, e as EventArgs) _ 
     Handles Control1.GotFocus

Console.WriteLine("You are in the Control.GotFocus event.")

End Sub

Observações

Quando muda o foco usando o teclado (TAB, SHIFT+TAB, etc.), chamando os Select métodos ou SelectNextControl , ou definindo a ContainerControl.ActiveControl propriedade para a forma atual, os eventos de foco ocorrem pela seguinte ordem:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Quando muda o foco usando o rato ou chamando o Focus método, os eventos de foco ocorrem pela seguinte ordem:

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

Se a CausesValidation propriedade for definida como false, os Validating eventos e Validated são suprimidos.

Note Os eventos GotFocus e LostFocus são eventos de foco de baixo nível ligados às mensagens WM_KILLFOCUS e WM_SETFOCUS Windows. Normalmente, os GotFocus eventos e LostFocus são usados apenas ao atualizar UICues ou ao escrever controlos personalizados. Em vez disso, os Enter eventos e Leave devem ser usados para todos os controlos, exceto para a Form classe, que usa os Activated eventos and Deactivate . Para mais informações sobre os GotFocus eventos, LostFocus consulte os tópicos WM_SETFOCUS e WM_KILLFOCUS .

Caution

Não tente definir o foco a partir dos Entermanipuladores de eventos, GotFocus, Leave, LostFocusValidating, , ou Validated de eventos. Fazer isso pode fazer com que a sua aplicação ou o sistema operativo deixem de responder. Para mais informações, consulte o tópico WM_KILLFOCUS .

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Aplica-se a

Ver também