Visual Basic: Windows Controls

FindItem Method (ListView Control)

See Also    Example    Applies To

Finds and returns a reference to a ListItem object in a ListView control.

Syntax

object.FindItem (string, value, index, match)

The FindItem method syntax has these parts:

Part	Description
object	Required. An object expression that evaluates to a ListView control.
string	Required. A string expression indicating the ListItem object to be found.
value	Optional. An integer or constant specifying whether the string will be matched to the ListItem object's Text, Subitems, or Tag property, as described in Settings.
index	Optional. An integer or string that uniquely identifies a member of an object collection and specifies the location from which to begin the search. The integer is the value of the Index property; the string is the value of the Key property. If no index is specified, the default is 1.
match	Optional. An integer or constant specifying that a match will occur if the item's Text property is the same as the string, as described in Settings.

Settings

The settings for value are:

Constant	Value	Description
lvwText	0	(Default) Matches the string with a ListItem object's Text property.
lvwSubitem	1	Matches the string with any string in a ListItem object's SubItems property.
lvwTag	2	Matches the string with any ListItem object's Tag property.

The settings for match are:

Constant	Value	Description
lvwWholeWord	0	(Default) An integer or constant specifying that a match will occur if the item's Text property begins with the whole word being searched. Ignored if the criteria is not text.
lvwPartial	1	An integer or constant specifying that a match will occur if the item's Text property begins with the string being searched. Ignored if the criteria is not text.

Remarks

If you specify Text as the search criteria, you can use lvwPartial so that a match occurs when the ListItem object's Text property begins with the string you are searching for. For example, to find the ListItem whose text is "Autoexec.bat", use:

'Create a ListItem variable.
Dim itmX As ListItem
'Set the variable to the found item.
Set itmX = ListView1.FindItem("Auto",,,lvwpartial)