wStateImage Property (Specific to Win32ListView Controls)

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


The list-view item can have the state image, which is displayed to the left of the full-sized or small icon. State images, such as checked and cleared check boxes, are used to indicate application-defined item states. State images are displayed in icon view, small icon view, list view, and report view. Use the wStateImage property to obtain a state image of the specified list-view item.


TestObj.wStateImage(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.


The property has the following parameters:


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.


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

Property Value

A Picture object that contains the item’s state image.


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

See Also

Getting List View Items' Images in Desktop Windows Applications
Picture Object
wImage Property (Specific to Win32ListView Controls)
wItem Property (ListView Controls)
wItemCount Property (ListView Controls)

Highlight search results