Compartilhar 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 aprender quando o evento ocorre e pode ajudá-lo na depuração.

Para executar o código de exemplo, cole-o em um projeto que contenha 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 e assim por diante), chamando os Select métodos ou SelectNextControl definindo a ContainerControl.ActiveControl propriedade para 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, os Focus 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 eventos e os ValidatingValidated eventos serão suprimidos.

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

Cuidado

Não tente definir o foco de dentro dos Entermanipuladores de eventos, GotFocusde , Leave, LostFocusValidatingou Validated de eventos. Isso pode fazer com que seu 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 manipular eventos, consulte Manipulando e gerando eventos.

Aplica-se a

Confira também