Export (0) Print
Expand All
Expand Minimize

DataGridView.SetCurrentCellAddressCore Method

Note: This method is new in the .NET Framework version 2.0.

Sets the currently active cell.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

protected virtual bool SetCurrentCellAddressCore (
	int columnIndex,
	int rowIndex,
	bool setAnchorCellAddress,
	bool validateCurrentCell,
	bool throughMouseClick
)
protected boolean SetCurrentCellAddressCore (
	int columnIndex, 
	int rowIndex, 
	boolean setAnchorCellAddress, 
	boolean validateCurrentCell, 
	boolean throughMouseClick
)
protected function SetCurrentCellAddressCore (
	columnIndex : int, 
	rowIndex : int, 
	setAnchorCellAddress : boolean, 
	validateCurrentCell : boolean, 
	throughMouseClick : boolean
) : boolean

Parameters

columnIndex

The index of the column containing the cell.

rowIndex

The index of the row containing the cell.

setAnchorCellAddress

true to make the new current cell the anchor cell for a subsequent multicell selection using the SHIFT key; otherwise, false.

validateCurrentCell

true to validate the value in the old current cell and cancel the change if validation fails; otherwise, false.

throughMouseClick

true if the current cell is being set as a result of a mouse click; otherwise, false.

Return Value

true if the current cell was successfully set; otherwise, false.

Exception typeCondition

ArgumentOutOfRangeException

columnIndex is less than 0 or greater than the number of columns in the control minus 1, and rowIndex is not -1.

-or-

rowIndex is less than 0 or greater than the number of rows in the control minus 1, and columnIndex is not -1.

InvalidOperationException

The specified cell has a Visible property value of false.

-or-

This method was called for a reason other than the underlying data source being reset, and another thread is currently executing this method.

InvalidCastException

The new current cell tried to enter edit mode, but its EditType property does not indicate a class that derives from Control and implements IDataGridViewEditingControl.

The DataGridView control uses this method whenever it changes the current cell. This method changes the current cell without changing the selection and optionally without validating the previous cell or changing the selection anchor cell. The anchor cell is the first cell of a block of multiple cells that the user can select by holding down the SHIFT key and clicking the last cell of the block.

If rowIndex and columnIndex are both -1, the CurrentCell property returns a null reference (Nothing in Visual Basic).

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft