Skip to content

Latest commit

 

History

History
64 lines (39 loc) · 3.78 KB

list-view-item-states.md

File metadata and controls

64 lines (39 loc) · 3.78 KB
title description ms.assetid topic_type api_name api_location api_type ms.topic ms.date
List-View Item States (CommCtrl.h)
An item's state value consists of the item's state, an optional overlay mask index, and an optional state image mask index.
21827f4a-f133-489b-bbd2-6979d1928b40
apiref
LVIS_ACTIVATING
LVIS_CUT
LVIS_DROPHILITED
LVIS_FOCUSED
LVIS_OVERLAYMASK
LVIS_SELECTED
LVIS_STATEIMAGEMASK
CommCtrl.h
HeaderDef
reference
05/31/2018

List-View Item States

An item's state value consists of the item's state, an optional overlay mask index, and an optional state image mask index.

An item's state determines its appearance and functionality. The state can be zero or one or more of the following values:

Constant Description
LVIS_ACTIVATING
Not currently supported.
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_OVERLAYMASK
The item's overlay image index is retrieved by a mask.
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_STATEIMAGEMASK
The item's state image index is retrieved by a mask.

Remarks

You can use the LVIS_OVERLAYMASK mask to isolate the one-based index of the overlay image. You can use the LVIS_STATEIMAGEMASK mask to isolate the one-based index of the state image.

Requirements

Requirement Value
Header
CommCtrl.h