See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Thismacro retrieves the state of a list-view item. You can use this macro or send the LVM_GETITEMSTATE message explicitly.
Syntax
UINT WINAPI ListView_GetItemState( HWND hwnd, int i, UINT mask ); |
Parameters
- 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.
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 maskparameter.
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.
Related message: LVM_GETITEMSTATE
Requirements
| Header | commctrl.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |