Partilhar via


Control.GotFocus Evento

Definição

Ocorre quando o controle recebe o foco.

public:
 event EventHandler ^ GotFocus;
[System.ComponentModel.Browsable(false)]
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 exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do GotFocus evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância de um tipo que herda de Control, como um Button ou ComboBox. Em seguida, nomeie a instância Control1 e verifique se o manipulador 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

Comentários

Quando você altera o foco usando o teclado (TAB, SHIFT+TAB etc.), chamando os métodos Select ou SelectNextControl, ou definindo a propriedade ContainerControl.ActiveControl como o formulário atual, os eventos de foco ocorrem na seguinte ordem:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Quando você altera o foco usando o mouse ou chamando o método Focus, os eventos de foco ocorrem na seguinte ordem:

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

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

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

Cuidado

Não tente definir o foco de dentro dos Entermanipuladores de eventos , LeaveGotFocus, LostFocus, , Validatingou Validated . Isso pode fazer com que o aplicativo ou o sistema operacional pare de responder. Para obter mais informações, consulte o tópico WM_KILLFOCUS .

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

Aplica-se a

Confira também