This property is not supported in web tests (including cross-platform web tests) that use XPath expressions and CSS selectors to locate web elements. This property can be only used in tests that locate web objects by using internal identification properties provided by TestComplete.

Description

Use the wItem property to get a text of a list box item by its index.

Declaration

TestObj.wItem(Index)

Read-Only Property

String

TestObj	A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Index	[in]	Required	Integer

Applies To

The property is applied to the following objects:

Developer Express ASPxListBox, Developer Express CheckedListBox, Developer Express CheckListBox and 13 more objects, Developer Express ListBox, Ext JS Time Picker, Java Swing List, List (Flex Objects), Oracle Forms List, Qt ListWidget, Silverlight ListBox, Telerik RadListBox for WinForms, Telerik RadListControl for WinForms, Web List Box, Win32 ListBox, WPF ListBox, XUL Listbox « Collapse the list

View Mode

This property is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

Parameters

The property has the following parameter:

Index

Specifies the index of the item whose text you want to get. The index is zero-based, that is, the first item has the index 0, the second - 1, and so on. The index of the last item is wItemCount - 1.

Property Value

A string holding the text of the specified item.

Remarks

If the specified item is not found, an error will occur and TestComplete will post an error message to the test log.

If you use Python or DelphiScript, you should enclose the parameter of the wItem property in square brackets: wItem[Index].

For WPF Controls: If a control uses data binding for its items, the wItem property may fail to get the specified item’s text and will return an empty string instead. To get the item’s text, you can use the control’s native properties.

Example

To view an example that demonstrates how to use the wItem property, see Getting a Single List Box Item.

wItem Property (ListBox Controls)