ListView_GetItemStateListView_GetItemState*
*Contents  *Index  *Topic Contents
*Previous Topic: ListView_GetItemSpacing
*Next Topic: ListView_GetItemText

ListView_GetItemState


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

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

hwnd
Handle to the list view control.
i
Index of the list view item.
mask
State information to retrieve. This parameter can be a combination of the following values:
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 information includes a set of bit flags as well as image list indexes that indicate the item's state image and overlay image.

See also ListView_SetItemState

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.