ListView_SetCallbackMask
A version of this page is also available for
4/8/2010
This macro changes the callback mask for a list-view control. You can use this macro or send the LVM_SETCALLBACKMASK message explicitly.
Syntax
BOOL ListView_SetCallbackMask(
HWND hwnd,
UINT mask
);
Parameters
- hwnd
Handle to the list-view control.
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.Value 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.
Return Value
TRUE indicates success. FALSE indicates failure.
Remarks
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's 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 information. After creating a list-view control and initializing its items, you can use the ListView_SetCallbackMask macro or 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, state images, and list-view callbacks, see User Interface Services.
Related message: LVM_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
Reference
LVN_GETDISPINFO
LVM_SETCALLBACKMASK
List-View Controls Macros