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.