When testing Win32 ListView controls, you can use specific properties of the corresponding test object as well as properties that TestComplete applies to all test and onscreen objects. All of these properties are listed below. The properties are organized into categories: Standard, Extended, RTTI, Debug Agent and others. For more information about this, see Categories of Object Methods and Properties.
Property List | View ↓
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. |
ControlId |
Specifies the control identifier of the window. |
Enabled |
Specifies whether an object can accept user input or not. |
Exists
|
Tells you whether an object exists in the system. |
Focused |
Specifies whether the control has input focus. |
FullName
|
Specifies the full name that uniquely identifies the object in TestComplete. |
Handle |
Returns the control’s handle (HWND). |
Height |
Specifies the height of the object in pixels. |
HScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s horizontal scroll bar. |
Id
|
Returns the object’s identifier. |
Index |
Specifies the front-to-back position of the control among other controls that have the same class name and caption, and belong to the same parent window. |
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. |
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. |
Parent
|
Returns the parent object of the given object. |
PopupMenu |
Returns a Menu object that provides a scripting interface to the control’s context menu (the menu must be opened on screen first). |
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. |
Unicode |
Specifies whether the control is a native Unicode window. |
Visible |
Specifies whether the object is visible to users. |
VisibleOnScreen |
Specifies whether any part of the object is currently visible on screen. |
VScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s vertical scroll bar. |
wBackground |
Returns information about the background image. |
wChecked |
Returns True if the item is checked, else False. |
wColumnCount |
Returns the total number of columns in the list-view. |
wCut |
Returns True if the item is marked for a cut-and-paste operation. |
wFocused |
Returns True if the item is focused, else False. |
wGroup |
Returns the information about the group to which the specified item belongs. |
wGroupCount |
Returns the number of groups in the list-view control. |
wGroups |
Returns information about the group specified by identifier or index. |
wHeader |
Returns a Win32Header object that provides a scripting interface to the header of the list-view control. |
wIconBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s icon. |
Width |
Specifies the width of the object in pixels. |
wImage |
Returns the image of the specified list-view item. |
wItem |
Returns the caption of the item specified by its index. |
wItemBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the entire list-view item. |
wItemCount |
Returns the total number of items in the list-view. |
wListSeparator |
Returns the total number of items in the list-view. |
wListViewStyleEx |
Returns information about the extended styles of the list-view control. |
wLParam |
Returns the application-defined value specific to the item. |
WndCaption |
Specifies the caption of a window object. |
WndClass |
Returns the class name of a window object. |
WndStyles |
Returns a value that is a combination of object style constants. |
WndStylesEx |
Returns a combination of constants that specify an extended object style. |
wSelectBounds |
Returns a Bounds object that provides a scripting interface to the item’s bounding rectangle, excluding column descriptions in the report view. |
wSelected |
Returns True if the item is selected, else False. |
wSelectedItems |
Returns a string holding the captions of all items currently selected, separated by wListSeparator property value. |
wStateImage |
Returns the state image for the specified list-view item. |
wTextBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s text label. |
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. |
ControlId |
Specifies the control identifier of the window. |
Enabled |
Specifies whether an object can accept user input or not. |
Exists
|
Tells you whether an object exists in the system. |
Focused |
Specifies whether the control has input focus. |
FullName
|
Specifies the full name that uniquely identifies the object in TestComplete. |
Handle |
Returns the control’s handle (HWND). |
Height |
Specifies the height of the object in pixels. |
Id
|
Returns the object’s identifier. |
Index |
Specifies the front-to-back position of the control among other controls that have the same class name and caption, and belong to the same parent window. |
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. |
Unicode |
Specifies whether the control is a native Unicode 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. |
WndCaption |
Specifies the caption of a window object. |
WndClass |
Returns the class name of a window object. |
WndStyles |
Returns a value that is a combination of object style constants. |
WndStylesEx |
Returns a combination of constants that specify an extended object style. |
Extended
This category includes properties that extend test functionality for the Win32 ListView objects.
Name | Description |
---|---|
HScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s horizontal scroll bar. |
PopupMenu |
Returns a Menu object that provides a scripting interface to the control’s context menu (the menu must be opened on screen first). |
VScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s vertical scroll bar. |
wBackground |
Returns information about the background image. |
wChecked |
Returns True if the item is checked, else False. |
wColumnCount |
Returns the total number of columns in the list-view. |
wCut |
Returns True if the item is marked for a cut-and-paste operation. |
wFocused |
Returns True if the item is focused, else False. |
wGroup |
Returns the information about the group to which the specified item belongs. |
wGroupCount |
Returns the number of groups in the list-view control. |
wGroups |
Returns information about the group specified by identifier or index. |
wHeader |
Returns a Win32Header object that provides a scripting interface to the header of the list-view control. |
wIconBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s icon. |
wImage |
Returns the image of the specified list-view item. |
wItem |
Returns the caption of the item specified by its index. |
wItemBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the entire list-view item. |
wItemCount |
Returns the total number of items in the list-view. |
wListSeparator |
Returns the total number of items in the list-view. |
wListViewStyleEx |
Returns information about the extended styles of the list-view control. |
wLParam |
Returns the application-defined value specific to the item. |
wSelectBounds |
Returns a Bounds object that provides a scripting interface to the item’s bounding rectangle, excluding column descriptions in the report view. |
wSelected |
Returns True if the item is selected, else False. |
wSelectedItems |
Returns a string holding the captions of all items currently selected, separated by wListSeparator property value. |
wStateImage |
Returns the state image for the specified list-view item. |
wTextBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s text label. |
<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
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.
Name | Description |
---|---|
wBackground |
Returns information about the background image. |
wChecked |
Returns True if the item is checked, else False. |
wColumnCount |
Returns the total number of columns in the list-view. |
wCut |
Returns True if the item is marked for a cut-and-paste operation. |
wFocused |
Returns True if the item is focused, else False. |
wGroup |
Returns the information about the group to which the specified item belongs. |
wGroupCount |
Returns the number of groups in the list-view control. |
wGroups |
Returns information about the group specified by identifier or index. |
wHeader |
Returns a Win32Header object that provides a scripting interface to the header of the list-view control. |
wIconBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s icon. |
wImage |
Returns the image of the specified list-view item. |
wItem |
Returns the caption of the item specified by its index. |
wItemBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the entire list-view item. |
wItemCount |
Returns the total number of items in the list-view. |
wListSeparator |
Returns the total number of items in the list-view. |
wListViewStyleEx |
Returns information about the extended styles of the list-view control. |
wLParam |
Returns the application-defined value specific to the item. |
wSelectBounds |
Returns a Bounds object that provides a scripting interface to the item’s bounding rectangle, excluding column descriptions in the report view. |
wSelected |
Returns True if the item is selected, else False. |
wSelectedItems |
Returns a string holding the captions of all items currently selected, separated by wListSeparator property value. |
wStateImage |
Returns the state image for the specified list-view item. |
wTextBounds |
Returns a Bounds object that provides a scripting interface to the bounding rectangle of the item’s text label. |