ListView_SetCallbackMask
The ListView_SetCallbackMask
macro changes the callback mask for a list view control. You can use this macro
or explicitly send the LVM_SETCALLBACKMASK message.
BOOL ListView_SetCallbackMask(
|
WND hwnd, |
|
|
UINT mask |
|
|
); |
|
Parameters
hwnd
Handle to the
list view control.
mask
Specifies the
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. This value can
be any combination of the following constants:
|
Value |
Meaning |
|
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 more information about overlay images and state images, see List
View Image Lists.
Return Values
Returns TRUE
if successful or FALSE otherwise.
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, see Callback Items and the Callback Mask.
See Also