Control.LostFocus Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque le contrôle perd le focus.
public:
event EventHandler ^ LostFocus;[System.ComponentModel.Browsable(false)]
public event EventHandler LostFocus;[System.ComponentModel.Browsable(false)]
public event EventHandler? LostFocus;[<System.ComponentModel.Browsable(false)>]
member this.LostFocus : EventHandler Public Custom Event LostFocus As EventHandler Type d'événement
- Attributs
Exemples
L’exemple de code suivant illustre la validation du texte pour TextBox1. Il illustre également la gestion de l’événement LostFocus en définissant la FileDialog.InitialDirectory propriété sur le texte dans TextBox1. L’exemple de code a utilisé la ErrorProvider.GetError méthode pour rechercher une erreur avant d’ouvrir la boîte de dialogue fichier. Pour exécuter cet exemple, collez le code suivant dans un formulaire contenant un nom, un nommé, un Button nommé Button1et un ErrorProvider nommé ErrorProvider1.OpenFileDialog1TextBoxOpenFileDialogTextBox1 Vérifiez que tous les événements sont associés à leurs gestionnaires d’événements.
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 = gcnew System::IO::DirectoryInfo( TextBox1->Text );
directory->GetFiles();
ErrorProvider1->SetError( TextBox1, "" );
}
catch ( System::ArgumentException^ )
{
ErrorProvider1->SetError( TextBox1, "Please enter a directory" );
}
catch ( System::IO::DirectoryNotFoundException^ )
{
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.
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.
void Button1_Click( System::Object^ sender, System::EventArgs^ e )
{
//If there is no error, then open the dialog box.
if ( ErrorProvider1->GetError( TextBox1 )->Equals( "" ) )
{
::DialogResult dialogResult = OpenFileDialog1->ShowDialog();
}
}
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();
}
}
Private Sub TextBox1_Validating(ByVal sender As Object, _
ByVal e As System.ComponentModel.CancelEventArgs) _
Handles TextBox1.Validating
' 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
Dim directory As New System.IO.DirectoryInfo(TextBox1.Text)
directory.GetFiles()
ErrorProvider1.SetError(TextBox1, "")
Catch ex1 As System.ArgumentException
ErrorProvider1.SetError(TextBox1, "Please enter a directory")
Catch ex2 As System.IO.DirectoryNotFoundException
ErrorProvider1.SetError(TextBox1, _
"The directory does not exist." & _
"Try again with a different directory.")
End Try
End Sub
' This method handles the LostFocus event for TextBox1 by setting the
' dialog's InitialDirectory property to the text in TextBox1.
Private Sub TextBox1_LostFocus(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles TextBox1.LostFocus
OpenFileDialog1.InitialDirectory = TextBox1.Text
End Sub
' This method demonstrates using the ErrorProvider.GetError method
' to check for an error before opening the dialog box.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
'If there is no error, then open the dialog box.
If ErrorProvider1.GetError(TextBox1) = "" Then
Dim dialogResult As DialogResult = OpenFileDialog1.ShowDialog()
End If
End Sub
Remarques
Lorsque vous modifiez le focus à l’aide du clavier (TAB, Maj+Tab, et ainsi de suite), en appelant ou SelectSelectNextControl en définissant la ContainerControl.ActiveControl propriété sur le formulaire actif, les événements de focus se produisent dans l’ordre suivant :
Lorsque vous modifiez le focus à l’aide de la souris ou en appelant la Focus méthode, les événements de focus se produisent dans l’ordre suivant :
Si la CausesValidation propriété est définie falsesur , les Validating événements et Validated les événements sont supprimés.
Si la Cancel propriété de l’événement CancelEventArgs est définie true dans le Validating délégué d’événement, tous les événements qui se produisent généralement après la suppression de l’événement Validating .
Note
Les GotFocus événements et LostFocus les événements sont des événements de focus de bas niveau liés aux messages WM_KILLFOCUS et WM_SETFOCUS Windows. En règle générale, les événements et LostFocus les événements sont utilisés uniquement lors de la mise à jour UICues ou lors de l’écriture GotFocus de contrôles personnalisés. Au lieu de cela, les Enter événements doivent Leave être utilisés pour tous les contrôles, à l’exception de la Form classe, qui utilise les événements et Deactivate les Activated événements. Pour plus d’informations sur les événements et LostFocus les GotFocus événements, consultez les rubriques WM_KILLFOCUS et WM_KILLFOCUS.
Avertissement
N’essayez pas de définir le focus à partir des gestionnaires d’événements, Validated et ValidatingLostFocusLeaveGotFocusnon à partir de l’intérieur des Entergestionnaires d’événements. Cela peut entraîner l’arrêt de la réponse de votre application ou du système d’exploitation. Pour plus d’informations, consultez la rubrique WM_KILLFOCUS .
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
