ListView_SetItemImage Method

Description

This method will set the image of an item in the control. If a ListView with a Report style is called the optional nColIndex may need to be used, otherwise it's not required for any other style of ListView.

Parameters

MyControlReference: Reference to the control in the form of MyProject_MyForm_MyControl.
ProjectFile: String identifying the project as it was passed in LoadProject.
DialogName: String identifying the dialog by name.
ControlName: String identifying the control by name.
nRowIndex: Integer specifying row index.
nColIndex: Integer specifying column index.
nNewImageIndex: Integer specifying index of the picture in the list defined at design to the control.

Return Values

Returns the following according to the situation:

T when successful.
Nil if the control is not found, does not support this function or if there is no such row or column.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

Copy Code
(Odcl_ListView_SetItemImage MyControlReference [as Reference] nRowIndex [as Integer] [Optional] nColIndex [as Integer] nNewImageIndex [as Integer])

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

Copy Code
(Odcl_ListView_SetItemImage ProjectFile [as String] DialogName [as String] ControlName [as String] nRowIndex [as Integer] [Optional] nColIndex [as Integer] nNewImageIndex [as Integer])

Remarks

This method is not available for the BlockList control.

Applies For

ListView.

Example

Copy Code
; Update the image of the third row on the fourth column (Odcl_ListView_SetItemImage MyProject_MyForm_MyControl 2 3 9)