sapgui_select_menu

General Object Functions

Selects a menu item.

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

sapgui_select_menu emulates a user opening a menu and selecting a menu item.

Return Values

This function returns LR_PASS (0) on success or LR_FAIL (1) on failure.

Parameterization

You can parameterize all string (char type) arguments.

Example

The following example uses sapgui_select_menu to create a new session. The function was recorded by choosing the System menu, then the Create Session menu entry.

sapgui_select_menu("Create session",
    "mbar/menu[4]/menu[0]", 
    BEGIN_OPTIONAL, 
        "AdditionalInfo=sapgui2011", 
    END_OPTIONAL);

sapgui_select_active_session("ses[1]");
sapgui_select_active_window("wnd[0]");