Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

LVM_SETCALLBACKMASK 
wParam = (WPARAM)(UINT) 
mask; 

lParam = 0;

Parameters

mask

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 maskof 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 Common Controls Reference.

lParam

Not used.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

Related macro:  ListView_SetCallbackMask

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also