Properties Added to TextObject Objects

Applies to TestComplete 15.69, last modified on November 13, 2024

The TextObject object provides a scripting interface to objects that are exposed by the Text Recognition technology. It contains all methods, properties and actions of the onscreen objects and an extra Text property that returns the recognized text.

Property List   | View

Standard

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

Name Description
_NewEnum Returns an enumerator for the collection of children that belong to the object.
ChildCount Returns the number of child objects of the given object.
Enabled Specifies whether an object can accept user input or not.
Exists Tells you whether an object exists in the system.
FullName Specifies the full name that uniquely identifies the object in TestComplete.
Height Specifies the height of the object in pixels.
Id Returns the object’s identifier.
Left Specifies the horizontal position of the object’s left edge relative its parent window.
MappedName Returns the custom name that is mapped to the original object name and is used to address the object in scripts.
Name Returns the object name.
Parent Returns the parent object of the given object.
ScreenLeft Specifies the horizontal position of the object’s left edge in screen coordinates.
ScreenTop Specifies the vertical position of the object’s top edge in screen coordinates.
Top Specifies the vertical position of the object’s top edge relative to the object’s parent window.
Visible Specifies whether the object is visible to users.
VisibleOnScreen Specifies whether any part of the object is currently visible on screen.
Width Specifies the width of the object in pixels.
<Name Mapping>

These properties 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
NamedChild Returns a child object stored in the Name Mapping repository (by its index).
NamedChildCount Returns the number of child objects of an object stored in the Name Mapping repository.
NodeDescription Returns the description of an object stored in the Name Mapping repository.
Other Categories

Name Description
Index Specifies the object position in the onscreen control or window.
Text Returns the text recognized by the Text Recognition technology.

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

TextObject Object

Highlight search results