Handling a Tab Strip Control 

A tab strip control is a control that allows you to display different controls and fields on different pages. The tab strip contains buttons which determine which page is active.

The tab strip control is described in the the control structure (IT_CTRL). More specific information on the tab strip control is in IT_TABSTRIPINFO.

Tab Strip Control Parts

A tab strip control in SAPGUI has the following parts:

Page Types

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.

Tab Strip Control Hierarchy

The tab strip control is the parent control of the tabs in the tab strip. It is also the parent of a Control Manager (control of dlgtype CTRL_MANAGER).

The Control Manager in turn is the parent of all the controls on the tab strip page. For example, if the tab strip page contains two frames, these two frames are the children of the Control Manager. The Control Manager is not visible on the screen. It merely acts as a container for the other controls on the tab strip control page.

The following diagram shows the controls on a tab strip control.

The following diagram shows the hierachy of the controls in a tab strip, that is, it shows the parent-child relationship of these controls.

The information on the various controls which are a part of the tab strip is in the control structure (IT_CTRL).

Using Tab Strip Controls

general information on a tab strip control (as on any other 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 you can use the ItEv_GetControlInfo function.

Switching to a Particular Tab

  1. 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.
  2. 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);