SapGuiVerifyTabSelected Function

Action

This function verifies whether a tab is currently the selected one inside a tab control.

Include file

SapGui.bdh

Syntax

SapGuiVerifyTabSelected( in sControlId : string, 
                         in bSelected  : boolean,
                         in nSeverity  : numberoptional := SEVERITY_ERROR ) : boolean;
Parameter Description
sControlId The unique id of the tab.
bSelected If the parameter is set to "true", the verification will succeed when the tab is selected.
nSeverity Optional: Severity of the error that is raised if the verification fails. Can be one of the following values:
  • SEVERITY_SUCCESS: Success; no error (numerical value: 0)
  • SEVERITY_INFORMATIONAL: Informational; no error (numerical value: 1)
  • SEVERITY_WARNING: Warning; no error (numerical value: 2)
  • SEVERITY_ERROR: (Default) Error; simulation continues (numerical value: 3)
  • SEVERITY_TRANS_EXIT: Error; the active transaction is aborted (numerical value: 4)
  • SEVERITY_PROCESS_EXIT: Error; the simulation is aborted (numerical value: 5)

Return value

  • true if successful
  • false otherwise

Example

transaction TMain
  var
    sText : string;
    sConnID : string;
  begin

    // Connecting to SAP
    sConnID := SapGuiOpenConnection( " /SAP_CODEPAGE=1100 /FULLMENU 10.5.2.132 0 /3");
    SapGuiSetActiveConnection(sConnID);
    SapGuiSetActiveSession("ses[0]");

    // SAP
    SapGuiSetActiveWindow("wnd[0]", "SAP", SAPGUI_MATCH_ExactNoCase);
    SapGuiWindowAction(SAPGUI_WND_MAXIMIZE);

    // Logon to SAP System
    // Before running a test you have to customize the password parameter!
    ThinkTime(2.0);
    SapGuiLogon("ddic", "minisap", "000", "");
    SapGuiVerifyTabSelected("/usr/tabsG_SELONETABSTRIP/tabpTAB002/", true, SEVERITY_ERROR);
  end TMain;