Contents



DH_ListSearch

Next

Function:

Searches a List for items that contain occurrences of the specified Search String, and selects the first item that has a match. The number of matching items is reported, and the Find Next and Find Prev functions move forward and backward in the list from one matching item to another when more than one is found. The index of the selected item is also reported. Partial matches are supported, and matching is not case-sensitive. For instance, a search string of "vi" will match both Clavinet and Violin.



Left-hand side pins:

List - Any of the available list selection sub-controls can be connected here, and can be used in the normal manner to select from the list independently of the search

Search String - The sequence of characters to be matched.

Find Next - Advances selection to the next item in the list that contains an occurrence of the Search String.

Find Prev - Selects the previous item in the list that contains an occurrence of the Search String.

# Found - The number of list items that contain occurrences of the Search String.


Right
-hand side pins:

List - Connects to any sub-control left-hand side list pin.

Search String - Alternative input pin for the sequence of characters to be matched.

Index - The index of the currently selected item in the list (-1 if nothing is selected).

Top

Next