LVM_GETITEMSTATE Overview  Group

The LVM_GETITEMSTATE message retrieves the state of a list view item. You can send this message explicitly or by using the ListView_GetItemState macro.

An item’s state information includes a set of bit flags, as well as image list indexes that indicate the item’s state image and overlay image.

LVM_GETITEMSTATE 

wParam = (WPARAM) (int) i; 

lParam = (LPARAM) (UINT) mask; 

 

Parameters

hwnd 

Handle to the list view control.

i

Index of the list view item.

mask

Specifies the state information to retrieve. This parameter can be a combination of the following values:

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, so it is surrounded by a standard focus rectangle. Although more than one item may be selected, only one item can have the focus.
LVIS_SELECTED	The item is selected. The appearance of a selected item depends on whether it has the focus, and on the system colors used for selection.
LVIS_OVERLAYMASK	Use this mask to retrieve the item’s overlay image index.
LVIS_STATEIMAGEMASK	Use this mask to retrieve the item’s state image index.

Return Values

Returns the current state for the specified item. The only valid bits in the return value are those that correspond to the bits set in the mask parameter.

See Also

ListView_GetItemState, LVM_SETITEMSTATE