wImage Property (Specific to Win32ListView Controls)

Applies to TestComplete 15.62, last modified on March 19, 2024

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)

Highlight search results