Compartilhar via


DataGridView.EditingControlShowing Evento

Definição

Ocorre quando um controle para edição de uma célula está aparecendo.

public:
 event System::Windows::Forms::DataGridViewEditingControlShowingEventHandler ^ EditingControlShowing;
public event System.Windows.Forms.DataGridViewEditingControlShowingEventHandler EditingControlShowing;
public event System.Windows.Forms.DataGridViewEditingControlShowingEventHandler? EditingControlShowing;
member this.EditingControlShowing : System.Windows.Forms.DataGridViewEditingControlShowingEventHandler 
Public Custom Event EditingControlShowing As DataGridViewEditingControlShowingEventHandler 

Tipo de evento

Exemplos

O exemplo de código a seguir ilustra como manipular esse evento para alterar a BackColor propriedade da célula atual. Para executar este exemplo, cole o código em um formulário que contém um DataGridView nomeado dataGridView1 e verifique se o EditingControlShowing evento está associado ao manipulador de eventos.

private void dataGridView1_EditingControlShowing(object sender, 
    DataGridViewEditingControlShowingEventArgs e)
{
    e.CellStyle.BackColor = Color.Aquamarine;
}
Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    e.CellStyle.BackColor = Color.Aquamarine

End Sub

Comentários

Você pode manipular esse evento para executar a inicialização personalizada do controle de edição quando uma célula entra no modo de edição. Para personalizar as características de exibição do controle, defina as propriedades do objeto retornado pela DataGridViewEditingControlShowingEventArgs.CellStyle propriedade . Para executar outra inicialização, converta o valor da DataGridViewEditingControlShowingEventArgs.Control propriedade para o tipo de controle específico e acesse os membros diretamente. Por exemplo, você pode manipular o EditingControlShowing evento para anexar manipuladores de eventos aos eventos do controle de edição.

Observação

O DataGridView controle hospeda um controle de edição por vez e reutiliza o controle de edição sempre que o tipo de célula não é alterado entre edições. Ao anexar manipuladores de eventos ao controle de edição, você deve, portanto, tomar precauções para evitar anexar o mesmo manipulador várias vezes. Para evitar esse problema, remova o manipulador do evento antes de anexar o manipulador ao evento. Isso impedirá a duplicação se o manipulador já estiver anexado ao evento, mas não terá efeito de outra forma. Para obter mais informações, consulte o código de exemplo na visão geral da DataGridViewComboBoxEditingControl classe.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Aplica-se a

Confira também