In This Topic ▼

LILITEM

Summary

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

Syntax

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;

Members

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() operator 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.

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.