Spread Windows Forms 6.0 Product Documentation
Search(Int32,String,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Int32,Int32,Int32,Int32) Method
See Also  Example Support Options
FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > FpSpread Class > Search Method : Search(Int32,String,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Int32,Int32,Int32,Int32) Method


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
startRowIndex
Index of row at which to start
startColumnIndex
Index of column at which to start
foundRowIndex
Index of row at which match is found
foundColumnIndex
Index of column at which match is found

Glossary Item Box

Searches the text in the specified range of cells in the specified sheet for the specified string with the specified criteria.

Syntax

Visual Basic (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 startRowIndex As Integer, _
   ByVal startColumnIndex As Integer, _
   ByRef foundRowIndex As Integer, _
   ByRef foundColumnIndex As Integer _
) As String
Visual Basic (Usage)Copy Code
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 startRowIndex As Integer
Dim startColumnIndex As Integer
Dim foundRowIndex As Integer
Dim foundColumnIndex As Integer
Dim value As String
 
value = instance.Search(sheetIndex, searchString, caseSensitive, exactMatch, alternateSearch, useWildcards, includeCellText, includeNotes, includeTags, startRowIndex, startColumnIndex, 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
startRowIndex
Index of row at which to start
startColumnIndex
Index of column at which to start
foundRowIndex
Index of row at which match is found
foundColumnIndex
Index of column at which match is found

Return Value

String containing the entire cell text in which the 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 the options for whether to search other areas beyond the data in the cells. You can search optionally any or all of the data cells, the cell notes, or the cell tags or any combination. It starts at the cell location specified (with startRowIndex and startColumnIndex) and goes to the end of the sheet until the string match is found.

This search method searches all the cells that contain data that can be represented as a string by the Text property of that cell, and that includes hidden and locked cells.

This search method checks the formatted string, that is the Text in the cell, not the Value.

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.

Example

This examples returns the location of the specified string.
C#Copy Code
int x = 0; 
int y = 0; 
fpSpread1.Search(0, "test", false, false, false, false, true, false, false, 0, 0, ref x, ref y);
listBox1.Items.Add(x.ToString()); 
listBox1.Items.Add(y.ToString()); 
Visual BasicCopy Code
Dim x As Integer 
Dim y As Integer
FpSpread1.Search(0, "test", False, False, False, False, True, False, False, 0, 0, x, y)
ListBox1.Items.Add(x)
ListBox1.Items.Add(y)

Requirements

Target Platforms: Windows 7, 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

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.