Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ListView_GetItemState

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

Thismacro retrieves the state of a list-view item. You can use this macro or send the LVM_GETITEMSTATE message explicitly.


UINT WINAPI ListView_GetItemState( 
  HWND hwnd, 
  int i, 
  UINT mask 
);

hwnd

Handle to the list-view control.

i

Index of the list-view item.

mask

State information to retrieve. It can be 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.

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.

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.

Related message: LVM_GETITEMSTATE

Headercommctrl.h
Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show:
© 2015 Microsoft