Control.LostFocus Evento

Definição

Ocorre quando o controle perde o foco.

C#
[System.ComponentModel.Browsable(false)]
public event EventHandler LostFocus;
C#
[System.ComponentModel.Browsable(false)]
public event EventHandler? LostFocus;

Tipo de evento

Atributos

Exemplos

O exemplo de código a seguir demonstra a validação do texto para TextBox1. Ele também demonstra o tratamento do LostFocus evento definindo a FileDialog.InitialDirectory propriedade como o texto em TextBox1. O exemplo de código usou o ErrorProvider.GetError método para marcar um erro antes de abrir a caixa de diálogo do arquivo. Para executar este exemplo, cole o código a seguir em um formulário que contém um TextBox chamado TextBox1, um OpenFileDialog chamado OpenFileDialog1, um Button chamado Button1e um ErrorProvider chamado ErrorProvider1. Verifique se todos os eventos estão associados aos manipuladores de eventos.

C#
private void textBox1_Validating(object sender, 
    System.ComponentModel.CancelEventArgs e)
{
    // If nothing is entered,
    // an ArgumentException is caught; if an invalid directory is entered, 
    // a DirectoryNotFoundException is caught. An appropriate error message 
    // is displayed in either case.
    try
    {
        System.IO.DirectoryInfo directory = 
            new System.IO.DirectoryInfo(textBox1.Text);
        directory.GetFiles();
        errorProvider1.SetError(textBox1, "");
    }
    catch(System.ArgumentException ex1)
    {
        errorProvider1.SetError(textBox1, "Please enter a directory");
    }
    catch(System.IO.DirectoryNotFoundException ex2)
    {
        errorProvider1.SetError(textBox1, "The directory does not exist." +
            "Try again with a different directory.");
    }
}

// This method handles the LostFocus event for textBox1 by setting the 
// dialog's InitialDirectory property to the text in textBox1.
private void textBox1_LostFocus(object sender, System.EventArgs e)
{
    openFileDialog1.InitialDirectory = textBox1.Text;
}

// This method demonstrates using the ErrorProvider.GetError method 
// to check for an error before opening the dialog box.
private void button1_Click(System.Object sender, System.EventArgs e)
{
    //If there is no error, then open the dialog box.
    if (errorProvider1.GetError(textBox1)=="")
    {
        DialogResult dialogResult = openFileDialog1.ShowDialog();
    }
}

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.

Se a Cancel propriedade do CancelEventArgs for definida true como no delegado de Validating eventos, todos os eventos que normalmente ocorreriam após o Validating evento são suprimidos.

Observação

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_KILLFOCUS 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

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Confira também