Share via


LVM_GETITEMSTATE (Compact 2013)

3/28/2014

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

Syntax

LVM_GETITEMSTATE wParam = (WPARAM)(int) i; 
    lParam = (LPARAM)(UINT) mask;

Parameters

  • i
    Index of the list-view item.
  • mask
    State data to retrieve. It is one or a combination of the following values.

    Value

    Description

    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.

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

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

Requirements

Header

commctrl.h

See Also

Reference

List-View Controls Messages
ListView_GetItemState