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


FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > FpSpread Class > Search Method : Search(Int32,String,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Int32,Int32,Int32,Int32,Boolean,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
Whether the search includes the content in the cell
Whether the search includes the content in the cell notes
Whether the search includes the content in the cell tags or their string representations
Whether the search is in reversed order
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
Specifies whether to search the specified block of cells only
Index of row at which match is found
Index of column at which match is found
Searches the text in the cells in the specified sheet for the specified string with the specified criteria and the location to start and end, and whether to search notes and tags as well.
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 includeCellText As Boolean, _
   ByVal includeNotes As Boolean, _
   ByVal includeTags As Boolean, _
   ByVal reverseSearching As Boolean, _
   ByVal startRowIndex As Integer, _
   ByVal startColumnIndex As Integer, _
   ByVal endRowIndex As Integer, _
   ByVal endColumnIndex As Integer, _
   ByVal searchAsBlockRange As Boolean, _
   ByRef foundRowIndex As Integer, _
   ByRef foundColumnIndex As Integer _
) As SearchFoundFlags
'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 includeCellText As Boolean
Dim includeNotes As Boolean
Dim includeTags As Boolean
Dim reverseSearching As Boolean
Dim startRowIndex As Integer
Dim startColumnIndex As Integer
Dim endRowIndex As Integer
Dim endColumnIndex As Integer
Dim searchAsBlockRange As Boolean
Dim foundRowIndex As Integer
Dim foundColumnIndex As Integer
Dim value As SearchFoundFlags
 
value = instance.Search(sheetIndex, searchString, caseSensitive, exactMatch, alternateSearch, useWildcards, includeCellText, includeNotes, includeTags, reverseSearching, startRowIndex, startColumnIndex, endRowIndex, endColumnIndex, searchAsBlockRange, 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
includeCellText
Whether the search includes the content in the cell
includeNotes
Whether the search includes the content in the cell notes
includeTags
Whether the search includes the content in the cell tags or their string representations
reverseSearching
Whether the search is in reversed order
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
searchAsBlockRange
Specifies whether to search the specified block of cells only
foundRowIndex
Index of row at which match is found
foundColumnIndex
Index of column at which match is found
Remarks

The searchAsBlockRange will limit the search to the range as if it is a block of cells. If the search starts with row 0, column 1 and ends at row 3, column 3 then column 0 would not be searched and columns after 3 would not be searched. With searchAsBlockRange set to true, the default search will go from left to right first and then top to bottom. An alternate search would go from top to bottom and then left to right.

If searchAsBlockRange is false then the search will include all cells in the sheet after the specified cell (including cells not in the range).

There are two cases where the searchAsBlockRange parameter is useful:
case 1: alternateSearch = false, searchAsBlockRange is only used when endColumnIndex < startColumnIndex (invalid):
- searchAsBlockRange = true: nothing is adjusted and returns an error value (invalid range)
- searchAsBlockRange = false: range is adjusted as follows:
startColumnIndex = 0
startRowIndex++
case 2: alternateSearch = true, searchAsBlockRange is only used when endRowIndex < startRowIndex (invalid):
- searchAsBlockRange = true: nothing is adjusted and returns an error value (invalid range)
- searchAsBlockRange = false: range is adjusted as follows:
startRowIndex = 0
startColumnIndex++

Example
This example uses the Search method.
fpSpread1.Sheets[0].Cells[1, 2].Text = "Tent";
int x = 0;
int y = 0;            
fpSpread1.Search(0, "te?t", false, false, false, true, true, true, true, false, 0, 0, 3, 3, true, ref x, ref y);
listBox1.Items.Add(x);
listBox1.Items.Add(y);
fpSpread1.Sheets(0).Cells(1, 2).Text = "Tent"
Dim x As Integer = 0
Dim y As Integer = 0
fpSpread1.Search(0, "te?t", False, False, False, True, True, True, True, False, 0, 0, 3, 3, True, x, y)
ListBox1.Items.Add(x)
ListBox1.Items.Add(y)
See Also

Reference

FpSpread Class
FpSpread Members
Overload List