SapGuiIteratorGetObjectAt Function

Action

This functions reads and provides the value of a collection at a specified position. This function has to be used if the expected value is not of a simple type but a complex one.

For simple types the function SapGuiIteratorGetValueAt has to be used. The returned object handle has to be freed by calling SapGuiObjectFree when no longer needed.

Include file

SapGui.bdh

Syntax

SapGuiIteratorGetObjectAt( in  nIterator : number,
                           in  nPos      : number,
                           out nObj      : number ) : boolean;
Parameter Description
nIterator The handle to the collection iterator
nPos The position of the value to be read.
nObj This parameter will be assigned the handle of the object to be read.

Return value

  • true if successful
  • false otherwise

Example

transaction TMain
  var
    sConnID       : string;
    i             : number;
    nIterator     : number;
    nType         : number;
    nObject, nObj : number;
    bRet          : boolean;
    sStr1, sStr2  : string;
  begin

    // Connecting to SAP
    sConnID := SapGuiOpenConnection(" /SAP_CODEPAGE=1100 /FULLMENU 10.5.2.198 0 /3");
    SapGuiSetActiveConnection(sConnID);
    SapGuiSetActiveSession("ses[0]");
  
    // SAP
    SapGuiSetActiveWindow("wnd[0]", "SAP", SAPGUI_MATCH_Exact);
    SapGuiWindowAction(SAPGUI_WND_MAXIMIZE);
  
    // Logon to SAP System
    SapGuiIgnoreError(SAPENGINE_STATUSBAR_CHANGED, SEVERITY_SUCCESS);
    ThinkTime(2.8);
    SapGuiLogon("ddic", "minisap", "000", ""); 
  
    // Copyright
    ThinkTime(2.1);
    SapGuiSetActiveWindow("wnd[1]", "Copyright", SAPGUI_MATCH_Exact);
    SapGuiPressButton("tbar[0]/btn[0]");
  
    // SAP Easy Access
    ThinkTime(9.9);
    SapGuiSetActiveWindow("wnd[0]", "SAP Easy Access", SAPGUI_MATCH_Exact);
    SapGuiGetPropertyCollection("wnd[0]", "Children", nIterator);
    SapGuiIteratorGetObjectAt(nIterator, 0, nObj);
    SapGuiObjectFree(nObj);
    SapGuiIteratorRelease(nIterator);
  end TMain;