DataGridView.CellMouseClick Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Acontece sempre que o utilizador clica em qualquer parte de uma célula com o rato.
public:
event System::Windows::Forms::DataGridViewCellMouseEventHandler ^ CellMouseClick;public event System.Windows.Forms.DataGridViewCellMouseEventHandler CellMouseClick;member this.CellMouseClick : System.Windows.Forms.DataGridViewCellMouseEventHandler Public Custom Event CellMouseClick As DataGridViewCellMouseEventHandler Tipo de Evento
Exemplos
O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do CellMouseClick evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo DataGridView chamada DataGridView1. Depois, certifique-se de que o gestor de eventos está associado ao CellMouseClick evento.
private void DataGridView1_CellMouseClick(Object sender, DataGridViewCellMouseEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ColumnIndex", e.ColumnIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Button", e.Button );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Clicks", e.Clicks );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Delta", e.Delta );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Location", e.Location );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "CellMouseClick Event" );
}
Private Sub DataGridView1_CellMouseClick(sender as Object, e as DataGridViewCellMouseEventArgs) _
Handles DataGridView1.CellMouseClick
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "ColumnIndex", e.ColumnIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Button", e.Button)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Clicks", e.Clicks)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Delta", e.Delta)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Location", e.Location)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"CellMouseClick Event")
End Sub
Observações
Este evento ocorre quando o utilizador clica usando qualquer um dos botões do rato. Use a MouseEventArgs.Button propriedade para determinar qual botão foi clicado.
Para detetar cliques no conteúdo de uma célula, como um botão ou ligação dentro de uma célula, use o CellContentClick evento.
O manipulador deste evento recebe o índice da coluna e o índice de linhas da posição do ponteiro do rato.
Para cliques num DataGridViewCheckBoxCell, este evento ocorre antes da caixa de seleção mudar de valor, por isso, se não quiser calcular o valor esperado com base no valor atual, normalmente irá tratar do CellValueChanged evento em vez disso. Como esse evento só ocorre quando o valor especificado pelo utilizador é confirmado, o que normalmente ocorre quando o foco sai da célula, também tens de tratar do CurrentCellDirtyStateChanged evento. Nesse handler, se a célula atual for uma célula de caixa de seleção, chama o CommitEdit método e passa o Commit valor.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.