Callback Items and the Callback Mask

For each of its items, a list view control typically stores the label text, the image list index of the item's icons, and a set of bit flags for the item's state. You can define individual items as callback items, which are useful if your application already stores some of the information for an item.

You define an item as a callback item by specifying appropriate values for the pszText and iImage members of the LVITEM structure (see CListCtrl::GetItem). If the application maintains the item's or subitem's text, specify the LPSTR_TEXTCALLBACK value for the pszText member. If the application keeps track of the icon for the item, specify the I_IMAGECALLBACK value for the iImage member.

In addition to defining callback items, you can also modify the control's callback mask. This mask is a set of bit flags that specify the item states for which the application, rather than the control, stores the current data. The callback mask applies to all of the control's items, unlike the callback item designation, which applies to a specific item. The callback mask is zero by default, meaning that the control tracks all item states. To change this default behavior, initialize the mask to any combination of the following values:

  • LVIS_CUT The item is marked for a cut-and-paste operation.

  • LVIS_DROPHILITED The item is highlighted as a drag-and-drop target.

  • LVIS_FOCUSED The item has the focus.

  • LVIS_SELECTED The item is selected.

  • LVIS_OVERLAYMASK The application stores the image list index of the current overlay image for each item.

  • LVIS_STATEIMAGEMASK The application stores the image list index of the current state image for each item.

For further information on retrieving and setting this mask, see CListCtrl::GetCallbackMask and CListCtrl::SetCallbackMask.

See also

Using CListCtrl