DataGridView.CellClick イベント

定義

セルの一部がクリックされた場合に発生します。Occurs when any part of a cell is clicked.

public:
 event System::Windows::Forms::DataGridViewCellEventHandler ^ CellClick;
public event System.Windows.Forms.DataGridViewCellEventHandler CellClick;
member this.CellClick : System.Windows.Forms.DataGridViewCellEventHandler 
Public Custom Event CellClick As DataGridViewCellEventHandler 

次のコード例では、@no__t 1 コントロールの image 列を使用する Vs-tac-Toe ゲーム実装の @no__t 0 イベントハンドラーを示します。The following code example shows a CellClick event handler in a Tic-Tac-Toe game implementation that uses image columns in a DataGridView control. ゲームが終了していない場合、またはセルが既にクリックされている場合を除き、イベントハンドラーによって、セルの値は、@no__t 変数によって表される2つの @no__t 0 オブジェクトの1つである-1 と o に設定されます。Unless the game is over or the cell has already been clicked, the event handler sets the cell value to one of two Bitmap objects represented by the variables x and o.

このコードは、@no__t で示す大きな例の一部です。Windows フォーム DataGridView コントロール @ no__t の Image 列を操作します。This code is part of a larger example shown in How to: Work with Image Columns in the Windows Forms DataGridView Control.

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}


private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}
Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

注釈

このイベントは、罫線や余白など、セルの任意の部分がクリックされたときに発生します。This event occurs when any part of a cell is clicked, including borders and padding. また、ボタンのセルまたはチェックボックスのセルにフォーカスがあるときにユーザーが SPACE キーを押すと、スペースキーを押したときにセルがクリックされたときに、これらのセルの種類に対して2回発生します。It also occurs when the user presses and releases the SPACE key while a button cell or check box cell has focus, and will occur twice for these cell types if the cell is clicked while pressing the SPACE key.

セルの内容がクリックされたことを確認するには、@no__t 0 のイベントを処理します。To determine when the cell contents are clicked, handle the CellContentClick event.

このイベントは、マウスの位置に関する情報を受け取りません。This event does not receive information about the mouse position. イベントハンドラーがマウス位置に関する情報を必要とする場合は、CellMouseClick イベントを使用します。If the event handler needs information about the mouse position, use the CellMouseClick event.

@No__t 0 のクリックの場合、このイベントはチェックボックスが値を変更する前に発生します。したがって、現在の値に基づいて予期される値を計算しない場合は、通常は DataGridView.CellValueChanged イベントを処理します。For clicks in a DataGridViewCheckBoxCell, this event occurs before the check box changes value, so if you do not want to calculate the expected value based on the current value, you will typically handle the DataGridView.CellValueChanged event instead. このイベントが発生するのは、ユーザーが指定した値がコミットされた場合のみです。通常はフォーカスがセルから離れるときに発生するため、DataGridView.CurrentCellDirtyStateChanged イベントも処理する必要があります。Because that event occurs only when the user-specified value is committed, which typically occurs when focus leaves the cell, you must also handle the DataGridView.CurrentCellDirtyStateChanged event. このハンドラーで、現在のセルがチェックボックスセルの場合は、DataGridView.CommitEdit メソッドを呼び出し、Commit の値を渡します。In that handler, if the current cell is a check box cell, call the DataGridView.CommitEdit method and pass in the Commit value.

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。For more information about how to handle events, see Handling and Raising Events.

適用対象

こちらもご覧ください