ResetSelection(String,String,Int32,Boolean) Method

Clears the current selection and uses the specified information to reinitialize the selection.

Syntax

Visual Basic

'Declaration
 
Public Overloads Function ResetSelection( _
   ByVal rangesAddress As String, _
   ByVal activeCellAddress As String, _
   ByVal newActiveRangeIndex As Integer, _
   Optional ByVal extendRangeForMergedCells As Boolean _
) As Boolean

C#

public bool ResetSelection( 
   string rangesAddress,
   string activeCellAddress,
   int newActiveRangeIndex,
   bool extendRangeForMergedCells
)

Parameters

rangesAddress

The new selection ranges. There must be 1 or more ranges.

activeCellAddress

The cell to use for the ActiveCell. This must be within the specified rangesAddress.

newActiveRangeIndex

The index of the range that contains the active cell.

extendRangeForMergedCells

True to adjust the rangesAddress such that it contains any intersecting merged cells; otherwise false to use the range as it is.

Exceptions

Exception	Description
System.ArgumentException	The rangesAddress must contain at least 1 cell/range.
System.ArgumentOutOfRangeException	The newActiveRangeIndex must be an index within the specified rangesAddress.
System.ArgumentException	The activeCellAddress must be within the range index specified by the newActiveRangeIndex.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2