NMITEMACTIVATE structure (commctrl.h)

Contains information about an LVN_ITEMACTIVATE notification code.

Syntax

typedef struct tagNMITEMACTIVATE {
  NMHDR  hdr;
  int    iItem;
  int    iSubItem;
  UINT   uNewState;
  UINT   uOldState;
  UINT   uChanged;
  POINT  ptAction;
  LPARAM lParam;
  UINT   uKeyFlags;
} NMITEMACTIVATE, *LPNMITEMACTIVATE;

Members

hdr

Type: NMHDR

NMHDR structure that contains information about this notification code.

iItem

Type: int

Index of the list-view item. If the item index is not used for the notification, this member will contain -1.

iSubItem

Type: int

One-based index of the subitem. If the subitem index is not used for the notification or the notification does not apply to a subitem, this member will contain zero.

uNewState

Type: UINT

New item state. This member is zero for notification codes that do not use it.

uOldState

Type: UINT

Old item state. This member is zero for notification codes that do not use it.

uChanged

Type: UINT

Set of flags that indicate the item attributes that have changed. This member is zero for notifications that do not use it. Otherwise, it can have the same values as the mask member of the LVITEM structure.

ptAction

Type: POINT

POINT structure that indicates the location at which the event occurred, in client coordinates. This member is undefined for notification codes that do not use it.

lParam

Type: LPARAM

Application-defined value of the item. This member is undefined for notification codes that do not use it.

uKeyFlags

Type: UINT

Modifier keys that were pressed at the time of the activation. This member contains zero or a combination of the following flags:

Value	Meaning
LVKF_ALT	The key is pressed.
LVKF_CONTROL	The key is pressed.
LVKF_SHIFT	The key is pressed.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	commctrl.h