DataGridView.CellMouseClick-Ereignis

Dieses Ereignis tritt ein, wenn der Benutzer mit einer der Maustasten klickt. Mit der MouseEventArgs.Button-Eigenschaft können Sie bestimmten, welche Taste gedrückt wurde.

Ermitteln Sie mithilfe des CellContentClick-Ereignisses, ob auf den Inhalt einer Zelle geklickt wurde, z. B. auf eine Schaltfläche oder ein Link in einer Zelle.

Der Handler für dieses Ereignis empfängt den Spaltenindex und den Zeilenindex der Mauszeigerposition.

Beim Klicken in einer DataGridViewCheckBoxCell tritt dieses Ereignis auf, bevor sich der Wert des Kontrollkästchens ändert. Wenn Sie nicht den erwarteten Wert auf Grundlage des aktuellen Werts berechnen möchten, behandeln Sie stattdessen das CellValueChanged-Ereignis. Da das Ereignis nur nach Übermitteln des vom Benutzer angegebenen Werts auftritt (in der Regel, nachdem der Fokus die Zelle verlassen hat), müssen Sie auch das CurrentCellDirtyStateChanged-Ereignis behandeln. Wenn es sich bei der aktuellen Zelle um eine Kontrollkästchenzelle handelt, rufen Sie in diesem Handler die CommitEdit-Methode auf, und übergeben Sie den Commit-Wert.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel erstellt ein Ereignishandler einen Bericht über das Eintreten des CellMouseClick-Ereignisses. Diesem Bericht können Sie entnehmen, wann das Ereignis eintritt. Außerdem kann der Bericht Sie beim Debuggen unterstützen. Wenn Sie einen Bericht über mehrere Ereignisse oder häufig eintretende Ereignisse erstellen möchten, sollten Sie MessageBox.Show durch Console.WriteLine ersetzen oder die Meldung an ein mehrzeiliges TextBox anfügen.

Fügen Sie den Beispielcode zum Ausführen in ein Projekt ein, das eine Instanz vom Typ DataGridView mit dem Namen DataGridView1 enthält. Stellen Sie anschließend sicher, dass der Ereignishandler dem CellMouseClick-Ereignis zugeordnet ist.

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" );
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referenz

Weitere Ressourcen