FindString(String,Int32,Int32) Method

In This Topic

Finds the first item after the given index which starts with the given string.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function FindString( _
   ByVal s As String, _
   ByVal startIndex As Integer, _
   ByVal findTargetColumnIndex As Integer _
) As Integer

'Usage
 
Dim instance As GcComboBox
Dim s As String
Dim startIndex As Integer
Dim findTargetColumnIndex As Integer
Dim value As Integer
 
value = instance.FindString(s, startIndex, findTargetColumnIndex)

public int FindString( 
   string s,
   int startIndex,
   int findTargetColumnIndex
)

Parameters

s: The System.String to search for.
startIndex: The zero-based index of the item before the first item to be searched.
findTargetColumnIndex: The System.Int32 value to which column index search in.

Return Value

The zero-based index of the first item found; returns -1 if no match is found.

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	The startIndex is out of range.
System.ArgumentOutOfRangeException	The findTargetColumnIndex is out of range.

Remarks

The search performed by this method is not case-sensitive. The s parameter is a substring to compare against the text associated with the items in the combo box list. The search performs a partial match starting from the beginning of the text, returning all of the items in the column located by findTargetColumnIndex of the list that matches the specified substring. You can then perform tasks, such as removing the item that contains the search text using the ListItemCollection.Remove method or changing the item's text. This method is typically used after a call has been made using the version of this method that does not specify a starting index. Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the startIndex parameter of the item after the first found instance of the search text. If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact(String,Int32,Int32) method.

Reference

GcComboBox Class
GcComboBox Members
Overload List

Product Support Forum | Print this page