LILITEM

typedef struct _LILITEM
{
   L_UINT uStructSize;
   L_UINT32 uMask;
   pBITMAPHANDLE pBitmap;
   L_UINT uBitmapStructSize;
   L_TCHAR * pText;
   L_INT32 lData;
   L_BOOL bSelected;
   L_INT32 lIndex; /* index of the item */
   L_TCHAR * pTextExt; /* the item's extended text */
} LILITEM, * pLILITEM;

The LILITEM structure contains information about a specific item in the image list.

Member	Description
uStructSize	Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.
uMask	Mask for getting and setting the item.
pBitmap	Pointer to a bitmap handle that references the item’s bitmap.
uBitmapStructSize	Size of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).
pText	Character string that contains the item’s text.
lData	Item’s user data.
bSelected	Flag that indicates whether or not the item is selected. Possible values are:
	Value	Meaning
	TRUE	The item is selected.
	FALSE	The item is not selected.
lIndex	Index of the specified item. This index is zero-based.
pTextExt	Character string that contains the item’s extra text.

Comments

lIndex is filled by L_ILM_GETITEM and L_ILM_GETSELITEMS messages.

Possible values for uMask are:

Value	Meaning
LILITEM_BITMAP	[0x01] Get/set the bitmap.
LILITEM_TEXT	[0x02] Get/set the text.
LILITEM_DATA	[0x04] Get/set the data.
LILITEM_SELECTED	[0x08] Get/set the selected flag.
LILITEM_TEXTEXT	[0x10] Get/set the extra text.

This structure is also used by the L_ILM_INSERT, L_ILM_INSERTAT, L_ILM_SETITEM and L_ILM_SETSELOPTIONS messages.

pTextExt can be used to store an extra text string for the item. For example, you can store the filename in pText (which gets displayed in the control), and the fully qualified path and filename in pTextExt.