wGroup Property (Specific to WIn32 ListView Controls)

Applies to TestComplete 15.47, last modified on January 20, 2023

Description

The items of the list view control can be organized into several groups. Use the wGroup property to obtain a group to which the specified list view item belongs. To obtain a group by it’s index or identifier use the wGroups property.

Declaration

TestObj.wGroup(Item, SubItem)

Read-Only Property A Win32ListView 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    
SubItem [in]    Optional    Variant Default value: 0   

Applies To

The property is applied to the following object:

View Mode

To view this property in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.

Parameters

The property has the following parameters:

Item

Specifies the desired item. You can enter the item’s index (from 0) or its caption. The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk (*) corresponds to a string of any length (including an empty string), the question mark corresponds to any single character (including none). To specify more complicated parts of a caption, use regular expressions.

The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

SubItem

Specifies the caption or zero-based index of the subitem for the Item

Property Value

A Win32ListViewGroup object that contains the group information.

If the specified item or subitem is not found in the list view, wGroup returns an empty value (Nothing in VBScript, null in JavaScript, JScript, C++Script and C#Script, None in Python and nil in DelphiScript) and posts an error message to the test log.

Remarks

If you use Python or DelphiScript, you should enclose the parameters of the wGroup property in square brackets: wGroup[Item, SubItem].

Example

To view an example that demonstrates how to use the wGroup property, see Working With List View Groups in Desktop Windows Applications.

See Also

Working With List View Groups in Desktop Windows Applications
Win32ListViewGroup Object
wGroups Property (Specific to Win32 ListView Controls)

Highlight search results