Item Property (GridGroupCollection Objects)

Applies to TestComplete 15.64, last modified on May 16, 2024


Use the Item property to get access to individual groups of the tested grid control. TestObj corresponds to a group collection of the control or to a subcollection.



Read-Only Property A GridGroup object
TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Item [in]    Required    Variant    

Applies To

The property is applied to the following object:

View Mode

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


The property has the following parameter:


Specifies the desired group. The Item parameter can have one of the following values:

  • The group’s index within the collection. Index is zero-based, that is it starts from 0. The index of the last group is Count-1.

  • The group’s caption or caption mask.

    To indicate variable parts of the item caption, you can use the asterisk (*) and question mark (?) wildcards. The asterisk corresponds to a string of any length, the question mark corresponds to any single character. The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

  • The path to the item, in case the desired item is a child item of the given collection. Each item in the path can be specified by its caption or index. Indexes must be enclosed in brackets - [ and ]. Individual captions and indexes in the path must be separated with pipeline characters ( | ).

    Note: If the item caption includes a bracket or a pipeline character, address the item by its index or with the question mark wildcard.

Property Value

A GridGroup object that provides information about the specified item.

See Also

GridGroup Object
Count Property (GridGroupCollection Objects)

Highlight search results