ItEv_FindControlEx 

Use

The definitions of the FC_FIND_STARTING_FROM and FC_COUNT (specified as part of the flags parameter of ItEv_FindControl) do not allow for effective searching when there are more than 255 controls on the screen.

The ItEv_FindControlEX performs similar operation as the ItEv_FindControl function, but it provides two parameters that allow you to specify a starting index and how many controls to search without the limitations of the FC_FIND_STARTING_FROM and FC_COUNT macros.

If you use them, then the startindex parameter overrides FC_FIND_STARTING_FROM for specifying the starting point for the search. The count parameter overrides FC_COUNT for specifying the distance of the search.

Syntax

DWORD DLEX ItEv_FindControlEx(PIT_EVENT pEvt, ITCCTRL *pCtrl,
DWORD startIndex, DWORD count, DWORD flags);

Parameters

pEvt

Pointer to the IT_EVENT structure.

pCtrl

A string identifying the control to find. Refer to Specifying control.

startIndex

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

count

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

flags

Flags that determine how to search for the control. For example, it allows you to specify where to start the search for the control and in which direction. Refer to Specifing control flag.

Return Value

Returns the 0-based index of the control found, or -1 if no control is found.

See Also

ItEv_FindControl.