Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

LVM_GETITEMSTATE message

Retrieves the state of a list-view item. You can send this message explicitly or by using the ListView_GetItemState macro.

Parameters

wParam

Index of the list-view item.

lParam

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

ValueMeaning
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 also 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 value

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 lParam parameter.

Remarks

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.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

See also

LVM_SETITEMSTATE

 

 

Community Additions

ADD
Show:
© 2015 Microsoft