Windows CE 3.0

This message sets the callback mask for a list view control. You can send this message explicitly or by using the ListView_SetCallbackMask macro.

lParam = 0;


Value of the callback mask. The bits of the mask indicate the item states or images for which the application stores the current state data. It can be any combination of the following constants:
Constant Description
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.

The callback mask of a list view control 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 items, unlike the callback item designation, which applies to a specific item. The callback mask is zero by default, meaning that the list view control stores all item state data. After creating a list view control and initializing its items, you can send the LVM_SETCALLBACKMASK message to change the callback mask. To get the current callback mask, send the LVM_GETCALLBACKMASK message.

For more information about overlay images and state images, see List View Image Lists.

For more information on overlay images, state images, and list view callbacks, see the Windows CE User Interface Services Guide.

Return Values

TRUE indicates success. FALSE indicates failure.


Related macro: ListView_SetCallbackMask


Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.