Description
Use the wImage property to obtain an image of the specified list view item.
Declaration
TestObj.wImage(Item, SubItem)
| Read-Only Property | A Picture 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 Picture object that contains the item’s image.
If the specified item or subitem is not found in the list view, wImage 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 wImage property in square brackets: wImage[Item, SubItem].
Depending on the current list view style, the wImage property returns large or small images of the specified item. To know which image is retrieved, use the Win32ListView.wImage.Size property of the corresponding Picture object.
Example
To view an example that demonstrates how to use the wImage property, see Getting List View Items' Images in Desktop Windows Applications.
See Also
Getting List View Items' Images in Desktop Windows Applications
Picture Object
wStateImage Property (Specific to Win32ListView Controls)
wItem Property (ListView Controls)
wItemCount Property (ListView Controls)