DataGridView.EditingControlShowing Evento

Definição

Ocorre quando um controlo para editar uma célula está a aparecer.

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 seguinte ilustra como lidar com este evento para alterar a BackColor propriedade da célula atual. Para executar este exemplo, cole o código num formulário que contenha um DataGridView nome dataGridView1 e assegure que o EditingControlShowing evento está associado ao gestor 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

Observações

Pode gerir este evento para realizar a inicialização personalizada do controlo de edição quando uma célula entra em modo de edição. Para personalizar as características de visualização do controlo, defina as propriedades do objeto devolvido pela DataGridViewEditingControlShowingEventArgs.CellStyle propriedade. Para realizar outras inicializações, conjure o valor da DataGridViewEditingControlShowingEventArgs.Control propriedade para o tipo de controlo específico e aceda diretamente aos membros. Por exemplo, pode gerir o EditingControlShowing evento para anexar gestores de eventos aos eventos do controlo de edição.

Note

O DataGridView controlo aloja um controlo de edição de cada vez e reutiliza o controlo de edição sempre que o tipo de célula não muda entre edições. Ao anexar handlers de eventos ao controlo de edição, deve, portanto, tomar precauções para evitar anexar o mesmo handler várias vezes. Para evitar este problema, remova o manipulador do evento antes de o ligar ao evento. Isto evitará duplicação se o manipulador já estiver ligado ao evento, mas não terá efeito caso contrário. Para mais informações, consulte o código de exemplo na DataGridViewComboBoxEditingControl visão geral da classe.

Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.

Aplica-se a

Ver também