commctrl.h

Mensaje LVM_SETCALLBACKMASK

Definición

LVM_SETCALLBACKMASK
    mask=(WPARAM)(UINT)wParam

Modifica la máscara de retrollamada para un control list-view. . Se puede enviar este mensaje explícitamente o bien usar la macro ListView_SetCallbackMask.

Descripción

mask

El valor de la máscara de retrollamada. Los bits en mask indican los estados de ítem o imágenes para los que la aplicación almacena el estado de datos actual. Este valor puede ser una combinación de las siguientes constantes:

ValorSignificado
LVIS_CUTEl ítem está marcado para una operación de corta-y-pega.
LVIS_DROPHILITEDEl ítem está resaltado como objetivo de un drag-and-drop.
LVIS_FOCUSEDEl ítem tiene el foco.
LVIS_SELECTEDEl ítem está seleccionado.
LVIS_OVERLAYMASKLa aplicación almacena el índice de la lista de imágenes de la imagen superpuesta actual para cada ítem.
LVIS_STATEIMAGEMASKLa aplicación almacena el índice de la lista de imágenes de la imagen de estado actual para cada ítem.

Valor de retorno

Devuelve TRUE si tiene éxito, o FALSE en caso contrario.

Observaciones

La máscara de retrollamada de un control list-view es un conjunto de bits que especifican los estados de ítem para los cuales la aplicación, en lugar del control, almacena los datos actuales. La máscara de retrollamada se aplica a todos los ítems del control, al contrario que la retrollamada de designación de ítem, que se aplica a un ítem específico. La ma´scara de retrollamada es cero por defecto, indicando que el control list-view almacena la información de estado de todos los ítems. Después de crear un control list-view e inicializar sus ítems, se puede usar la macro ListView_SetCallbackMask o el mensaje LVM_SETCALLBACKMASK para modificar la máscara de retrollamada. Para recuperar la máscara de retrollamada actual, enviar el mensaje LVM_GETCALLBACKMASK.