Assembly: System.Windows.Forms (in system.windows.forms.dll)
/** @property */ public DataGridViewCell get_CurrentCell () /** @property */ public void set_CurrentCell (DataGridViewCell value)
public function get CurrentCell () : DataGridViewCell public function set CurrentCell (value : DataGridViewCell)
Property ValueThe DataGridViewCell that represents the current cell, or a null reference (Nothing in Visual Basic) if there is no current cell. The default is the first cell in the first column or a null reference (Nothing in Visual Basic) if there are no cells in the control.
The value of this property cannot be set because changes to the current cell cannot be committed or canceled.
The specified cell when setting this property is in a hidden row or column.
The specified cell when setting this property is not in the DataGridView.
When you set a cell as the current cell, it will scroll into view if it is not currently displayed. The current cell cannot be a header cell, a disabled cell, or a cell in a hidden row or column.
You can set this property to a null reference (Nothing in Visual Basic) to temporarily remove the focus rectangle, but when the control receives focus and the value of this property is a null reference (Nothing in Visual Basic), it is automatically set to the value of the FirstDisplayedCell property.
When you change the value of this property, the SelectionChanged event occurs before the CurrentCellChanged event. Any SelectionChanged event handler accessing the CurrentCell property at this time will get its previous value.
When you bind the DataGridView to an external data source, this property is reset to its default value.
The following code example illustrates how to ensure that the current cell is visible after sorting by setting the FirstDisplayedCell property to the cell retrieved through the CurrentCell property. This code works only with an unbound DataGridView control. With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.
To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. In C#, you must also connect the Sorted event to the event handler.
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter EditionThe Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.