FindExtended 

long FindExtended (LPCTSTR Value, long Start, long Amount, long Flags)

Parameters

Value

String containing the control value to search for.

Flags

Flags controlling the search. See Specifying the Flags parameter topic in the GUI Library.

Start

Starting point for the search. This overrides FC_FIND_STARTING_FROM in flags.

Amount

How many controls to search. This overrides FC_COUNT in flags.

Return Value

Index of the first control satisfying the search criteria; -1 if not found.

Comments

Searches are for the initial substring, and are not case-sensitive. The flags controlling the search are described in the ItEv_FindControl GUI Library call. FindExtended finds a string value, using either a value or field name. FindFromExtended finds controls from a certain starting point without a string value (i.e., it uses ITCTRL_IDX macro for the value argument to ItEv_FindControl).

See Also

FindFromExtended, ItEv_FindControl.