Control.Leave É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 quand le focus d'entrée s'écarte du contrôle.
public:
event EventHandler ^ Leave;
public event EventHandler Leave;
public event EventHandler? Leave;
member this.Leave : EventHandler
Public Custom Event Leave As EventHandler
Type d'événement
Exemples
L’exemple de code suivant utilise l’événement Leave pour réinitialiser un contrôle à son état antérieur.
private:
void textBox1_Enter( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// If the TextBox contains text, change its foreground and background colors.
if ( textBox1->Text != String::Empty )
{
textBox1->ForeColor = Color::Red;
textBox1->BackColor = Color::Black;
// Move the selection pointer to the end of the text of the control.
textBox1->Select(textBox1->Text->Length,0);
}
}
void textBox1_Leave( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Reset the colors and selection of the TextBox after focus is lost.
textBox1->ForeColor = Color::Black;
textBox1->BackColor = Color::White;
textBox1->Select(0,0);
}
private void textBox1_Enter(object sender, System.EventArgs e)
{
// If the TextBox contains text, change its foreground and background colors.
if (!string.IsNullOrEmpty(textBox1.Text))
{
textBox1.ForeColor = Color.Red;
textBox1.BackColor = Color.Black;
// Move the selection pointer to the end of the text of the control.
textBox1.Select(textBox1.Text.Length, 0);
}
}
private void textBox1_Leave(object sender, System.EventArgs e)
{
// Reset the colors and selection of the TextBox after focus is lost.
textBox1.ForeColor = Color.Black;
textBox1.BackColor = Color.White;
textBox1.Select(0,0);
}
Private Sub textBox1_Enter(sender As Object, e As System.EventArgs) Handles textBox1.Enter
' If the TextBox contains text, change its foreground and background colors.
If textBox1.Text <> [String].Empty Then
textBox1.ForeColor = Color.Red
textBox1.BackColor = Color.Black
' Move the selection pointer to the end of the text of the control.
textBox1.Select(textBox1.Text.Length, 0)
End If
End Sub
Private Sub textBox1_Leave(sender As Object, e As System.EventArgs) Handles textBox1.Leave
' Reset the colors and selection of the TextBox after focus is lost.
textBox1.ForeColor = Color.Black
textBox1.BackColor = Color.White
textBox1.Select(0, 0)
End Sub
End Class
Remarques
Lorsque vous modifiez le focus à l’aide du clavier (TAB, MAJ+TAB, et ainsi de suite), en appelant les Select méthodes ou SelectNextControl ou en définissant la ContainerControl.ActiveControl propriété sur le formulaire actuel, 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é a la false
valeur , les Validating événements et Validated sont supprimés.
Notes
Les Enter événements et Leave sont supprimés par la Form classe . Les événements équivalents dans la Form classe sont les Activated événements et Deactivate . Les Enter événements et Leave sont hiérarchiques et sont montés en cascade dans la chaîne parente jusqu’à ce que le contrôle approprié soit atteint. Par exemple, supposons que vous avez un Form avec deux GroupBox contrôles, et que chaque GroupBox contrôle a un TextBox contrôle. Lorsque le caret est déplacé de l’un TextBox vers l’autre, l’événement Leave est déclenché pour et TextBoxGroupBox, et l’événement Enter est déclenché pour l’autre GroupBox et TextBox.
Attention
N’essayez pas de définir le Enterfocus à partir des gestionnaires d’événements , GotFocusLeave, LostFocus, Validating, ou Validated . 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.