SAP GUI Button Methods

Applies to TestComplete 14.93, last modified on October 12, 2021

When testing SAP GUI button controls, you can use specific methods of the corresponding test object as well as methods that TestComplete applies to all test and onscreen objects. All of these methods are listed below. The methods are organized into categories: Standard, Extended, RTTI, Debug Agent and others. For more information about this, see Categories of Object Methods and Properties.

Method List   | View

Standard

This category includes methods that TestComplete applies to all test objects.

Name Description
Child Returns a child object by its index.
Find Searches for a child object that has the specified property values.
FindAll Returns an array of child objects that have the specified property values.
FindAllChildren Returns an array of child objects that have the specified property values.
FindChild Searches for a child object that has the specified property values.
FindChildEx Searches for a child object that has the specified property values during the specified timeout period.
FindEx Searches for a child object that has the specified property values during the specified timeout period.
FindId Returns a child object by its identifier.
Picture Captures the image of the specified rectangular area of the object.
Refresh Refreshes the child object list.
ScreenToWindow Converts screen coordinates to coordinates relative to the object.
Validate Obsolete. Generates the OnValidate event for the object.
WaitChild Waits until the specified child object becomes available during the timeout period.
WaitProperty Waits until the specified object property achieves the specified value during the timeout period.
WindowToScreen Converts coordinates relative to the object to screen coordinates.
Actions

This category includes methods that simulate user actions on the tested controls.

Name Description
Click Simulates a click of the left mouse button over the object.
ClickButton Simulates a mouse click on the object.
ClickM Simulates a click of the middle mouse button over the object.
ClickR Simulates a click of the right mouse button over the object.
DblClick Simulates a double-click of the left mouse button over the object.
DblClickM Simulates a double-click of the middle mouse button over the object.
DblClickR Simulates a double-click of the right mouse button over the object.
Drag Simulates a dragging event performed with the left mouse button.
DragM Simulates a dragging event performed with the middle mouse button.
DragR Simulates a dragging event performed with the right mouse button.
HoverMouse Simulates moving the mouse pointer to the specified position within an object.
Keys Sends a keystroke to an object.
MouseWheel Simulates rotation of the mouse wheel over an object.
<Name Mapping>

These methods are available only if the test object has been mapped (see Name Mapping). You can use them in your tests, but they are not displayed in the Object Browser panel.

Name Description
AddNamedChild Adds the specified child object to Name Mapping.
GetUnderlyingObject Returns the test object, to which the given mapping item corresponds.
RefreshMappingInfo Instructs TestComplete to re-identify the mapped object using the identification information specified in Name Mapping.
RemoveNamedChild Deletes the specified child mapped object from Name Mapping.
WaitAliasChild Waits until the child object with the specified alias becomes available during the timeout period.
WaitNamedChild Waits until a child object with the specified mapped name becomes available during the timeout period.
Other Categories

If TestComplete has access to internal methods, properties and files of your tested application (that is, if it is an Open Application), you can call the internal methods and properties as methods and properties of the appropriate test objects. You can view these properties and methods in corresponding categories (Private, Public, RTTI, Debug Agent, Firefox, and so on). These methods and properties are not described in the TestComplete help file. For more information on them, please see the documentation for the development tools that was used to create the application under test.

See Also

SAP GUI Button Support

Highlight search results