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 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:
Quando você altera o foco usando o mouse ou chamando o método, os Focus eventos de foco ocorrem na seguinte ordem:
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.