Process Object Methods

Applies to TestComplete 12.60, last modified on September 17, 2018

The following methods are common for all process objects.

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.
Close Closes the process by sending the close command to its main window.
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.
IEFrame Obsolete. Provides access to the Internet Explorer browser window. Use the cross-browser BrowserWindow method instead.
Refresh Refreshes the child object list.
SaveDumpToFile Creates a process dump (a .dmp file).
SaveDumpToLog Creates a process dump (a .dmp file) in the project’s Log folder and adds the link to the dump to the test log.
Terminate Terminates the process.
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.
WaitWindow Delays the script execution until the specified top-level window of the process is created, or until the specified time period is over.
Window Returns a top-level window of the process.
Open App Objects

This category includes methods that provide access to child objects (windows) that the tested process may have. In general case, a child object can be created with any supported development tool or technology. That is why the category includes methods for accessing objects whose technology differs from the technology of the given process object.

Name Description
AppDomain Returns an object that provides a scripting interface to .NET application domains that exist in the given Windows process.
AWTObject Provides access to objects of Java AWT applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
CLXObject Provides access to CLX objects of Delphi and C++Builder Open Applications created with CLX classes. The returned object contains methods and properties defined in TestComplete and in the application code.
JavaFXObject Provides access to objects of JavaFX applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
JavaRuntime Returns the JavaRuntime object that provides access to a Java virtual machine loaded in the process.
Page This method is added to processes that correspond to the supported web browsers , as well as to the WPF Host process (PresentationHost) that executes WPF XAML Browser applications (XBAP).

The method returns the Page object that corresponds to a web page displayed in the browser.

QtObject Provides access to objects of Qt applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
SwingObject Provides access to objects of Java Swing applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
SWTObject Provides access to objects of Java SWT applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
UIAObject Provides access to an object, whose properties and methods are exposed via the UI Automation Support plugin. The returned object contains methods and properties defined by TestComplete and methods and properties provided by the Microsoft UI Automation Framework.
UIPage This method is only available if the Web Testing and Firefox Support plugins are installed in TestComplete.

The method is added to the window that corresponds to the Firefox browser window. It returns the object that provides access to toolbars, menus, buttons, edit boxes and other controls of the browser.

VBObject Provides access to objects of Visual Basic 6.0 applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
VCLNETObject Provides access to objects of .NET applications created with the Borland VCL.NET library. The returned object contains methods and properties defined both in TestComplete and in the application code.
VCLObject Provides access to objects of Delphi and C++Builder Open Applications. The returned object contains methods and properties defined both in TestComplete and in the application code.
WaitAppDomain Delays the script execution until the specified application domain becomes available to TestComplete, or until the specified time period passes.
WaitAWTObject Delays the script execution until the specified object of a Java AWT application becomes available to TestComplete, or until the specified time period is over.
WaitCLXObject Delays the script execution until the specified object of a Delphi or C++Builder application created with the Borland CLX library becomes available to TestComplete, or until the specified time period is over.
WaitJavaFXObject Delays the script execution until the specified object of a JavaFX application becomes available to TestComplete, or until the specified time period is over.
WaitJavaRuntime Delays the script execution until the specified java runtime loaded to the process becomes available to TestComplete, or until the specified time period passes.
WaitPage This method is added to processes that correspond to the supported web browsers.

The method delays the script execution until the specified web page is loaded or the specified time interval elapses.

WaitQtObject Delays the script execution until the specified object of a Qt application becomes available to TestComplete, or until the specified time period is over.
WaitSwingObject Delays the script execution until the specified object of a Java Swing application becomes available to TestComplete, or until the specified time period is over.
WaitSWTObject Delays the script execution until the specified object of a Java SWT application becomes available to TestComplete, or until the specified time period is over.
WaitUIAObject Delays the script execution until the specified window, whose methods and properties are exposed by the UI Automation Support plugin, becomes available to TestComplete, or until the specified timeout is over.
WaitVBObject Delays the script execution until the specified object of a Visual Basic 6.0 application becomes available to TestComplete, or until the specified time period is over.
WaitVCLNETObject Delays the script execution until the specified object of a .NET application created with the Borland VCL.NET library becomes available to TestComplete, or until the specified time period is over.
WaitVCLObject Delays the script execution until the specified window or onscreen object of a VCL Open Application becomes available to TestComplete, or until the specified time period is over.
WaitWFCObject Delays the script execution until the specified object of a Java WFC application becomes available to TestComplete, or until the specified time period is over.
WaitWinFormsObject Delays the script execution until the specified object of a .NET application created with the Microsoft Windows Forms library becomes available to TestComplete, or until the specified time period is over.
WaitWPFObject Delays the script execution until the specified object of a WPF application becomes available to TestComplete, or until the specified time period is over.
WFCObject Provides access to objects of Java applications created with the WFC library (for example, Microsoft J++ applications). The returned object contains methods and properties defined both in TestComplete and in the application code.
WinFormsObject Provides access to objects of .NET applications created with Microsoft Windows Forms library. The returned object contains methods and properties defined both in TestComplete and in the application code.
WPFObject Provides access to WPF application objects. The returned object contains methods and properties defined in both TestComplete and in the application's code.
<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

Process Object
Process Object Properties

Highlight search results