SftTree/OCX 7.0

SftTree.FindStringExact Method

Softel vdm, Inc.

Searches items for a string using an exact match.

Deprecated - Provided for compatibility with earlier versions only - Use Items.FindCellTextExact instead

Syntax       

VB.NET

FoundIndex = object.FindStringExact(ByVal ItemIndex As Integer, ByVal ColIndex As Short, ByVal SearchString As String)  As Integer

VB

FoundIndex = object.FindStringExact(ByVal ItemIndex As Long, ByVal ColIndex As Integer, ByVal SearchString As String)  As Long

C#.NET

int FoundIndex = object.FindStringExact(int ItemIndex, short ColIndex, string SearchString);

VC++

long FoundIndex = object->FindStringExact(long ItemIndex, short ColIndex, _bstr_t SearchString);

C

HRESULT object->raw_FindStringExact(long ItemIndex, short ColIndex, BSTR SearchString, long* FoundIndex);

Delphi

FoundIndex := object.FindStringExact(ItemIndex : Integer; ColIndex : Smallint; SearchString : WideString)   : Integer;

object

A SftTree object.

ItemIndex

The zero-based index of the item where the search begins (including ItemIndex).

ColIndex

The zero-based column number to be searched.

SearchString

The text to be searched.

FoundIndex

Returns the zero-based index of the item, where the specified SearchString is found.  -1 is returned if no item is found matching the specified SearchString.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Items.FindCellTextExact instead

The FindStringExact method searches items for a string using an exact match.

The string described by SearchString is compared to the Cell.Text property of all items and columns involved in the search.  The search starts at the item described by ItemIndex and is restricted to the column specified by ColIndex.  If an item with a matching Cell.Text property is found, its zero-based index is returned, otherwise -1 is returned.

Only one column can be searched at a time.

The comparison of SearchString and the Cell.Text property is not case sensitive.  The Cell.Text property and the SearchString must match in their entirety, partial strings do not match.  To find a partial match for SearchString use the Items.FindCellText method.

SearchString

Cell.Text Property

Match

Comment

ABC 

abc 

Yes 

Same string, case is ignored

abc 

abc123 

No 

Not the same string

abc 

Thisabc

No

Not the same string

abc 

ab 

No 

Not the same string

See Also  SftTree Object | Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com