LILITEM

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

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

Member

Description

lStructSize

Size of the structure.

uMask

Mask for getting and setting the item.

pBitmap

Pointer to a bitmap handle that references the item’s bitmap.

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

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 used by the LImageListControl::GetItem, LImageListControl::GetSelectedItems, LImageListControl::Insert, LImageListControl::Update, and LImageListControl::SortExt functions.

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.