Control.Enter 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 é inserido.
public:
event EventHandler ^ Enter;public event EventHandler Enter;public event EventHandler? Enter;member this.Enter : EventHandler Public Custom Event Enter As EventHandler Tipo de evento
Exemplos
O exemplo de código a seguir usa o Enter evento para alterar as cores de primeiro plano e de plano de fundo de um TextBox em condições específicas.
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
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.
Observação
Os Enter eventos e Leave são suprimidos pela Form classe . Os eventos equivalentes na Form classe são os Activated eventos e Deactivate . Os Enter eventos e Leave são hierárquicos e serão em cascata para cima e para baixo na cadeia pai até que o controle apropriado seja atingido. Por exemplo, suponha que você tenha um Form com dois GroupBox controles e cada GroupBox controle tenha um TextBox controle. Quando o cursor é movido de um TextBox para o outro, o Leave evento é gerado para e TextBoxGroupBoxe o Enter evento é gerado para o outro GroupBox e TextBox.
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 WM_KILLFOCUS tópico na seção "Referência de entrada do teclado" e a seção "Deadlocks de mensagem" do tópico Sobre mensagens e filas de mensagens .
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.
