Edit

Share via

NMLISTVIEW structure (commctrl.h)

  • Article

Contains information about a list-view notification message. This structure is the same as the NM_LISTVIEW structure but has been renamed to fit standard naming conventions.

Syntax

typedef struct tagNMLISTVIEW {
  NMHDR  hdr;
  int    iItem;
  int    iSubItem;
  UINT   uNewState;
  UINT   uOldState;
  UINT   uChanged;
  POINT  ptAction;
  LPARAM lParam;
} NMLISTVIEW, *LPNMLISTVIEW;

Members

hdr

Type: NMHDR

NMHDR structure that contains information about this notification message.

iItem

Type: int

Identifies the list-view item, or -1 if not used.

iSubItem

Type: int

Identifies the subitem, or zero if none.

uNewState

Type: UINT

New item state. This member is zero for notification messages that do not use it. For a list of possible values, see List-View Item States.

uOldState

Type: UINT

Old item state. This member is zero for notification messages that do not use it. For a list of possible values, see List-View Item States.

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. This member is undefined for notification messages that do not use it.

lParam

Type: LPARAM

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

Requirements

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