List - FindItem Method

Executes the OnFind method on the design interface for all list items

Member of List (PRIM_LIST)

Parameters

NameTypeData TypeDescription
Result*Result (Optional)PRIM_LIST.ListItemReference to the first item to return a true
Key*InputVariantValue to be searched for
StartItem*Input (Optional)PRIM_LIST.ListItemItem at which to start the search

Details

The FindItem method calls the OnFind method on the Prim_List.iListCellDesign interface implemented by the design instances.
 
If a True is returned by the design instance, the ListItem is returned as the Result.
 
FindItem processing will stop when an item is returned or no item is found.

Example

In this example the found items are given a style to highlight them.
Mthroutine Name(Find)
Define_Map For(*Input) Class(#Prim_Alph) Name(#Key)
 
   Define_Com Class(#prim_List.ListItem) Name(#FoundItem) Reference(*Dynamic)
 
      Begin_Loop
 
         #FoundItem <= #List.FindItem( #Key #FoundItem )
         Leave If(#FoundItem *Is *Null)
 
         #FoundItem.Style <= #MyStyles<Highlight>
 
      End_Loop
 
Endroutine

See also

All Component Classes

Technical Reference

Febuary 18 V14SP2