Admin Production ni-theme
Current Publication

SetListItemImage

LabWindows/CVI

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.

Supported Controls

You can use SetListItemImage with list box controls.

Parameters

Input
Name Type Description
panelHandle int Specifier for a particular panel that is currently in memory. You can obtain this handle from functions such as LoadPanel and NewPanel.
controlID int 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 functions such as NewCtrl and DuplicateCtrl.
itemIndex int Zero-based index into the list.
image int 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 int Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later