wItem Property (ListBox Controls)

Applies to TestComplete 15.42, last modified on September 08, 2022
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:

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 in Desktop Windows Applications.

See Also

wItemCount Property (ListBox Controls)
wFocus Property (ListBox Controls)
wSelected Property (ListBox Controls)

Highlight search results