Control.GotFocus Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
Quando você altera o foco usando o mouse ou chamando o método Focus, os eventos de foco ocorrem na seguinte ordem:
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.