commctrl.h

Macro ListView_GetItemState

Obtiene el estado de un ítem de un list-view. Se puede usar esta macro o enviar el mensaje LVM_GETITEMSTATE explícitamente.

Definición

DWORD ListView_GetItemState(
    HWND hwndLV,
    int i,
    UINT mask
);

Descripción

hwndLV
Un manipulador del control list-view.
i
El índice del ítem del list-view.
mask

La información de estado a recuperar. Este parámetro puede ser una combinación de los siguientes valores:

ValorSignificado
LVIS_CUTEl ítem está marcado para una operación de cortado y pegado.
LVIS_DROPHILITEDEl ítem está resaltado como objetivo de una operación de drag&drop.
LVIS_FOCUSEDEl ítem tiene el foco, así que está rodeado por el rectángulo de foco estándar. Aunque más de un ítem puede estar seleccionado, solo uno de ellos puede tener el foco.
LVIS_SELECTEDEl ítem está seleccionado. La apariencia de un ítem seleccionado depende de si tiene el foco y también de los colores de sistema usados para la selección.
LVIS_OVERLAYMASKUsar esta máscara para recuperar el índice de la imagen superpuesta del ítem.
LVIS_STATEIMAGEMASKUsar esta máscara para recuperar el índice de la imagen de estado del ítem.

Valor de retorno

Devuelve el estado actual para el ítem especificado. Los únicos bits válidos en el valor retornado son aquellos que corresponden con los bits asignados en el parámetro mask.

Observaciones

La información de estado de un ítem incluye un conjunto de banderas de bit así como índices de lista de imágenes que indican el estado del ítem y la imagen superpuesta.