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)