Handling a Tab Strip Control

Handling a Tab Strip Control

A tab strip control in SAPGUI has the following parts:

The tab button, which is identified by its name
The page, which is the area inside the tab strip, that is, the area containing the controls that are displayed when the user chooses the tab

There are two types of pages in SAPGUI:

Page Type	Description
Server page	When the user chooses the tab for a server page, the application gets the data from the R/3 application server.
Local page	When the user chooses the tab for a local page, the application gets the data from the local cache (because it already had gotten this data from the server.)

The R/3 application defines which pages are local and which pages are server pages.

Using Tab Strip Controls

The information on a tab strip control is in the control structure. Additional information that is more specific to the tab strip, such as how many pages are in the tab strip, is in the It_TabStripInfo structure. To obtain this information use the ItEv_GetControlInfo function.

Switching to a Particular Tab

Use ItEv_SetTabButton to specify which tab to switch to, that is, to specify which tab should become active. You can provide either the name, the value, or the index of the tab control.

Use It_SendEvent to send the tab-switching event to the application server.

This sends the contents of the event structure to the server.

Example

The following code shows an example of switching to a particular tab, using its index. The program obtains the tab index with the ITCTRL_IDX macro .

ItEv_SetTabButton(pEvt, ITCTRL_IDX(8);
It_SendEvent(hMr, &pEvt);