Spread Windows Forms 12.0 Product Documentation
Search(Int32,String,Boolean,Boolean,Boolean,Boolean,Int32,Int32,Int32,Int32,Int32,Int32) Method
Example 


FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > FpSpread Class > Search Method : Search(Int32,String,Boolean,Boolean,Boolean,Boolean,Int32,Int32,Int32,Int32,Int32,Int32) Method
Index of sheet on which to search
String for which to search
Whether the search considers the case of the letters in the search string
Whether the search considers only an exact match
Whether the search goes by alternate coordinates of column, row (instead of row, column)
Whether the search considers wildcard characters (*, ?) in the search string
Index of row at which to start
Index of column at which to start
Index of row at which to end
Index of column at which to end
Index of row at which match is found
Index of column at which match is found
Searches the text in the specified range of cells in the specified sheet for the specified string with the specified criteria.
Syntax
'Declaration
 
Public Overloads Function Search( _
   ByVal sheetIndex As Integer, _
   ByVal searchString As String, _
   ByVal caseSensitive As Boolean, _
   ByVal exactMatch As Boolean, _
   ByVal alternateSearch As Boolean, _
   ByVal useWildcards As Boolean, _
   ByVal startRowIndex As Integer, _
   ByVal startColumnIndex As Integer, _
   ByVal endRowIndex As Integer, _
   ByVal endColumnIndex As Integer, _
   ByRef foundRowIndex As Integer, _
   ByRef foundColumnIndex As Integer _
) As String
'Usage
 
Dim instance As FpSpread
Dim sheetIndex As Integer
Dim searchString As String
Dim caseSensitive As Boolean
Dim exactMatch As Boolean
Dim alternateSearch As Boolean
Dim useWildcards As Boolean
Dim startRowIndex As Integer
Dim startColumnIndex As Integer
Dim endRowIndex As Integer
Dim endColumnIndex As Integer
Dim foundRowIndex As Integer
Dim foundColumnIndex As Integer
Dim value As String
 
value = instance.Search(sheetIndex, searchString, caseSensitive, exactMatch, alternateSearch, useWildcards, startRowIndex, startColumnIndex, endRowIndex, endColumnIndex, foundRowIndex, foundColumnIndex)

Parameters

sheetIndex
Index of sheet on which to search
searchString
String for which to search
caseSensitive
Whether the search considers the case of the letters in the search string
exactMatch
Whether the search considers only an exact match
alternateSearch
Whether the search goes by alternate coordinates of column, row (instead of row, column)
useWildcards
Whether the search considers wildcard characters (*, ?) in the search string
startRowIndex
Index of row at which to start
startColumnIndex
Index of column at which to start
endRowIndex
Index of row at which to end
endColumnIndex
Index of column at which to end
foundRowIndex
Index of row at which match is found
foundColumnIndex
Index of column at which match is found

Return Value

String containing the text in the cell where the search string was found, or null if not found in a cell, is returned.

Also, the foundRowIndex and foundColumnIndex return the row index and column index of the cell in which the string is found.

Remarks

This search method is similar to the basic search method but adds an end cell location if you want to confine the search to a region of the spreadsheet. It starts at the cell location specified (with startRowIndex and startColumnIndex) and goes to the specified end (endRowIndex and endRowIndex) until the cell is found that contains the search string.

This search method has these qualifications:

For a hierarchy of sheets, this method only searches cells in a parent sheet. To search child sheets, you would need to perform a separate search of each child sheet.

This method is for backward compatibility with previous versions that could not search headers, notes, and tags. If you are searching these, you may use the other Search methods that return both the search found flag (SearchFoundFlag) as well as the cell location.

Example
This example performs a search on a range of cells, finds the cell that matches, and lists the row and column indexes of that cell.
int x = 0; 
int y = 0;
fpSpread1.Search(0, "te?t", false, false, false, true, 0, 0, 3, 3, ref x, ref y);
listBox1.Items.Add(x);
listBox1.Items.Add(y);
Dim x As Integer 
Dim y As Integer
FpSpread1.Search(0, "te?t", False, False, False, True, 0, 0, 3, 3, x, y)
ListBox1.Items.Add(x)
ListBox1.Items.Add(y)
See Also

Reference

FpSpread Class
FpSpread Members
Overload List