It_PeekTitle 

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.