Use
It_PeekTitle combines an It_PeekEvent with a comparison of the title of the screen to a title you specify.
This can be useful for error-checking the results of an It_SendEvent call (to see that the resulting screen is correct).
Syntax
DWORD DLEX It_PeekTitle(HANDLE hMr, PPIT_EVENT ppEvt, char *ptitle);
Parameters
hMr |
Connection handle |
ppEvt |
Pointer to a pointer to the IT_EVENT structure |
ptitle |
Event title to search for |
Return Value
TRUE if title of event matches ptitle argument; FALSE otherwise. Match test is case-insensitive and searches for initial substring.
Comments
Note that screen titles are not always unique in R/3, and therefore checking the title of the screen does not guarantee that you have accessed the correct screen. When working with R/3 application servers from release 3.1H and later, checking the szProgramName and szScreenName fields of the IT_SCREEN structure can be a more accurate way of checking the identification of the screen.
See Also
It_PeekEvent, IT_SCREEN.