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 |
|