sapgui_is_tab_selected

Verification and Data Retrieval Functions

Checks if the tab is selected.

int sapgui_is_tab_selected( const char *description, const char *tabID, [args,] LAST );
descriptionUser entered text to aid in understanding script
tabID Object ID Strings
argsOptional Arguments
LAST A marker indicating the end of the argument list. Not required if Optional Arguments are used.

The sapgui_is_tab_selected verification function returns a boolean value indicating if the tab tabID is currently selected.

Return Values

This function returns True (-1) or False (0).

Parameterization

You can parameterize all string (char type) arguments.

Example

The following example uses sapgui_is_tab_selected to determine whether the tab needs to be selected using sapgui_select_tab.

if (!sapgui_is_tab_selected("C: Material transferred from CAD system", 
    "usr/tabsG_SELONETABSTRIP/tabpTAB004", LAST))
    {
        sapgui_select_tab("C: Material transferred from CAD system",
        "usr/tabsG_SELONETABSTRIP/tabpTAB004", LAST );
    }