sapgui_set_text

Enters text in a control.

int sapgui_set_text( const char *description, const char *text, const char *controlID, [args,] LAST );

sapgui_set_text writes the value of the text argument to the control. If text is the literal text, place it in quotation marks: "The text to enter". If text is a file, the syntax is "file=filename.ext". The quotation marks are part of the syntax. The file must be in the script folder. You cannot use a path.

The "file=filename.ext" syntax is recorded when pasting a large amount of text unto the control. A file is created containing the pasted text, and the file is used instead of the clipboard when the test is run. The file can be edited. The file name can be parameterized, so different Vusers can use different files.

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 first example uses sapgui_set_text to enter the user name on the logon window. To record this step during logon as shown in the example, show operations on logon windows To record detail steps during logon clear Hide operations on logon windows: Choose Tools > Recording Options > SAPGUI > Code generation.

sapgui_set_text("User", 

    "MyUserName", 

    "usr/txtRSYST-BNAME", 

    BEGIN_OPTIONAL, 

        "AdditionalInfo=sapgui1004", 

    END_OPTIONAL);

The second example shows the use of sapgui_set_text to emulate dropping a file in a text edit control.

sapgui_set_text("", 

    "file=s201801.arg", 

    "usr/cntlSRC/shellcont/shell", 

    LAST );