SetListItemImage

int SetListItemImage (int panelHandle, int controlID, int itemIndex, int image);

Purpose

Places a predefined image in a list control at the left-hand side of the line that contains the specified item index.

You cannot use this function for picture ring controls. To change the image for a picture ring item, use SetImageBits.

Parameters

Input
Name Type Description
panelHandle integer Specifier for a particular panel that is currently in memory. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel.
controlID integer The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by NewCtrl or DuplicateCtrl.
itemIndex integer Zero-based index into the list.
image integer Specifies which image to display in the specified list item. The following table lists valid values.

Image Defined Constant
no folder VAL_NO_IMAGE
folder VAL_FOLDER
open folder VAL_OPEN_FOLDER
current folder VAL_CURRENT_FOLDER
plus VAL_PLUS
minus VAL_MINUS
blank image (spacer) VAL_BLANK_IMAGE (allows an entry to have no visible image but still line up with other entries containing an image)

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success