Win32 ListView Methods

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

When testing Win32 ListView 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.
ObjectFromPoint Returns the window or the onscreen object that contains the pixel with the specified coordinates.
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.
ClickItem Moves the mouse cursor to the Item and then simulates a single click. Item may be specified by index, from 0, or by caption.
ClickItemR Moves the mouse cursor to the Item and then simulates a right click. Item may be specified by index, from 0, or by caption.
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.
DblClickItem Moves the mouse cursor to Item and then simulates a double click of the left mouse button over it.
DblClickItemR Moves the mouse cursor to the Item and then simulates a double right-click. Item may be specified by index, from 0, or by caption.
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.
FocusItem Focuses a list-view item, specified by index (from 0), or by caption.
HotTrackSelect Simulates the hot track selection of a list-view item.
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.
SelectItem Selects an item specified by index, from 0, or by caption.
SetFocus Moves the input focus to an object.
Extended

This category includes methods that extend test functionality for the Win32 ListView objects.

Name Description
CheckItem Checks Item, specified by index, from 0, or by caption.
<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

Win32 ListView Support

Highlight search results