Default Keyboard and Mouse Handling in the Windows Forms DataGridView Control
The following tables describe how users can interact with the DataGridView control through a keyboard and a mouse.
.gif) Note |
|---|
To customize keyboard behavior, you can handle standard keyboard events such as KeyDown. In edit mode, however, the hosted editing control receives the keyboard input and the keyboard events do not occur for the DataGridView control. To handle editing control events, attach your handlers to the editing control in an EditingControlShowing event handler. Alternatively, you can customize keyboard behavior in a DataGridView subclass by overriding the ProcessDialogKey and ProcessDataGridViewKey methods. |
Default Keyboard Handling
Basic navigation and entry keys
| Key or key combination | Description |
|---|---|
DOWN ARROW |
Moves the focus to the cell directly below the current cell. If the focus is in the last row, does nothing. |
LEFT ARROW |
Moves the focus to the previous cell in the row. If the focus is in the first cell in the row, does nothing. |
RIGHT ARROW |
Moves the focus to the next cell in the row. If the focus is in the last cell in the row, does nothing. |
UP ARROW |
Moves the focus to the cell directly above the current cell. If the focus is in the first row, does nothing. |
HOME |
Moves the focus to the first cell in the current row. |
END |
Moves the focus to the last cell in the current row. |
PAGE DOWN |
Scrolls the control downward by the number of rows that are fully displayed. Moves the focus to the last fully displayed row without changing columns. |
PAGE UP |
Scrolls the control upward by the number of rows that are fully displayed. Moves focus to the first displayed row without changing columns. |
TAB |
If the StandardTab property value is false, moves the focus to the next cell in the current row. If the focus is already in the last cell of the row, moves the focus to the first cell in the next row. If the focus is in the last cell in the control, moves the focus to the next control in the tab order of the parent container. If the StandardTab property value is true, moves the focus to the next control in the tab order of the parent container. |
SHIFT+TAB |
If the StandardTab property value is false, moves the focus to the previous cell in the current row. If the focus is already in the first cell of the row, moves the focus to the last cell in the previous row. If the focus is in the first cell in the control, moves the focus to the previous control in the tab order of the parent container. If the StandardTab property value is true, moves the focus to the previous control in the tab order of the parent container. |
CTRL+TAB |
If the StandardTab property value is false, moves the focus to the next control in the tab order of the parent container. If the StandardTab property value is true, moves the focus to the next cell in the current row. If the focus is already in the last cell of the row, moves the focus to the first cell in the next row. If the focus is in the last cell in the control, moves the focus to the next control in the tab order of the parent container. |
CTRL+SHIFT+TAB |
If the StandardTab property value is false, moves the focus to the previous control in the tab order of the parent container. If the StandardTab property value is true, moves the focus to the previous cell in the current row. If the focus is already in the first cell of the row, moves the focus to the last cell in the previous row. If the focus is in the first cell in the control, moves the focus to the previous control in the tab order of the parent container. |
CTRL+ARROW |
Moves the focus to the farthest cell in the direction of the arrow. |
CTRL+HOME |
Moves the focus to the first cell in the control. |
CTRL+END |
Moves the focus to the last cell in the control. |
CTRL+PAGE DOWN/UP |
Same as PAGE DOWN or PAGE UP. |
F2 |
Puts the current cell into cell edit mode if the EditMode property value is EditOnF2 or EditOnKeystrokeOrF2. |
F4 |
If the current cell is a DataGridViewComboBoxCell, puts the cell into edit mode and displays the drop-down list. |
ALT+UP/DOWN ARROW |
If the current cell is a DataGridViewComboBoxCell, puts the cell into edit mode and displays the drop-down list. |
SPACE |
If the current cell is a DataGridViewButtonCell, DataGridViewLinkCell, or DataGridViewCheckBoxCell, raises the CellClick and CellContentClick events. If the current cell is a DataGridViewButtonCell, also presses the button. If the current cell is a DataGridViewCheckBoxCell, also changes the check state. |
ENTER |
Commits any changes to the current cell and row and moves the focus to the cell directly below the current cell. If the focus is in the last row, commits any changes without moving the focus. |
ESC |
If the control is in edit mode, cancels the edit. If the control is not in edit mode, reverts any changes that have been made to the current row if the control is bound to a data source that supports editing or virtual mode has been implemented with row-level commit scope. |
BACKSPACE |
Deletes the character before the insertion point when editing a cell. |
DELETE |
Deletes the character after the insertion point when editing a cell. |
CTRL+ENTER |
Commits any changes to the current cell without moving the focus. Also commits any changes to the current row if the control is bound to a data source that supports editing or virtual mode has been implemented with row-level commit scope. |
CTRL+0 |
Enters a System.DBNull.Value value into the current cell if the cell can be edited. By default, the display value for a DBNull cell value is the value of the NullValue property of the DataGridViewCellStyle in effect for the current cell. |
Selection Keys
If the MultiSelect property is set to false and the SelectionMode property is set to CellSelect, changing the current cell by using the navigation keys changes the selection to the new cell. The SHIFT, CTRL, and ALT keys do not affect this behavior.
If the SelectionMode is set to RowHeaderSelect or ColumnHeaderSelect, the same behavior occurs but with the following additions.
| Key or key combination | Description |
|---|---|
SHIFT+SPACEBAR |
Selects the full row or column (the same as clicking the row or column header). |
navigation key (arrow key, PAGE UP/DOWN, HOME, END) |
If a full row or column is selected, changing the current cell to a new row or column moves the selection to the full new row or column (depending on the selection mode). |
If MultiSelect is set to false and SelectionMode is set to FullRowSelect or FullColumnSelect, changing the current cell to a new row or column by using the keyboard moves the selection to the full new row or column. The SHIFT, CTRL, and ALT keys do not affect this behavior.
If MultiSelect is set to true, the navigation behavior does not change, but navigating with the keyboard while pressing SHIFT (including CTRL+SHIFT) will modify a multi-cell selection. Before navigation begins, the control marks the current cell as an anchor cell. When you navigate while pressing SHIFT, the selection includes all cells between the anchor cell and the current cell. Other cells in the control will remain selected if they were already selected, but they may become unselected if the keyboard navigation temporarily puts them between the anchor cell and the current cell.
If MultiSelect is set to true and SelectionMode is set to FullRowSelect or FullColumnSelect, the behavior of the anchor cell and current cell is the same, but only full rows or columns become selected or unselected.
Default Mouse Handling
Basic Mouse Handling
| Note |
|---|
Clicking a cell with the left mouse button always changes the current cell. Clicking a cell with the right mouse button opens a shortcut menu, when one is available. |
| Mouse action | Description |
|---|---|
Left mouse button down |
Makes the clicked cell the current cell, and raises the System.Windows.Forms.DataGridView.CellMouseDown event. |
Left mouse button up |
Raises the System.Windows.Forms.DataGridView.CellMouseUp event |
Left mouse button click |
Raises the System.Windows.Forms.DataGridView.CellClick and System.Windows.Forms.DataGridView.CellMouseClick events |
Left mouse button down, and drag on a column header cell |
If the System.Windows.Forms.DataGridView.AllowUserToOrderColumns property is true, moves the column so that it can be dropped into a new position. |
Mouse Selection
No selection behavior is associated with the middle mouse button or the mouse wheel.
If the MultiSelect property is set to false and the SelectionMode property is set to CellSelect, the following behavior occurs.
| Mouse action | Description |
|---|---|
Click left mouse button |
Selects only the current cell if the user clicks a cell. No selection behavior if the user clicks a row or column header. |
Click right mouse button |
Displays a shortcut menu if one is available. |
The same behavior occurs when the SelectionMode is set to RowHeaderSelect or ColumnHeaderSelect, except that, depending on the selection mode, clicking a row or column header will select the full row or column and set the current cell to the first cell in the row or column.
If SelectionMode is set to FullRowSelect or FullColumnSelect, clicking any cell in a row or column will select the full row or column.
If MultiSelect is set to true, clicking a cell while pressing CTRL or SHIFT will modify a multi-cell selection.
When you click a cell while pressing CTRL, the cell will change its selection state while all other cells retain their current selection state.
When you click a cell or a series of cells while pressing SHIFT, the selection includes all cells between the current cell and an anchor cell located at the position of the current cell before the first click. When you click and drag the pointer across multiple cells, the anchor cell is the cell clicked at the beginning of the drag operation. Subsequent clicks while pressing SHIFT change the current cell, but not the anchor cell. Other cells in the control will remain selected if they were already selected, but they may become unselected if mouse navigation temporarily puts them between the anchor cell and the current cell.
If MultiSelect is set to true and SelectionMode is set to RowHeaderSelect or ColumnHeaderSelect, clicking a row or column header (depending on the selection mode) while pressing SHIFT will modify an existing selection of full rows or columns if such a selection exists. Otherwise, it will clear the selection and start a new selection of full rows or columns. Clicking a row or column header while pressing CTRL, however, will add or remove the clicked row or column from the current selection without otherwise modifying the current selection.
If MultiSelect is set to true and SelectionMode is set to FullRowSelect or FullColumnSelect, clicking a cell while pressing SHIFT or CTRL behaves the same way except that only full rows and columns are affected.