LVN_GETDISPINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message requests a list-view control parent window to provide data needed to display or sort an item. It is sent in the form of a WM_NOTIFY message.

Syntax

LVN_GETDISPINFO pnmv = (LV_DISPINFO FAR *) lParam;

Parameters

• pnmv
  Pointer to an LVN_GETDISPINFO structure. On input, the LVITEM structure contained in this structure specifies the type of data required and identifies the item or subitem of interest.

  Use the LVITEM structure to return the requested data to the control. If your message handler sets the LVIF_DI_SETITEM flag in the mask member of the LVITEM structure, the list-view control stores the requested data and will not ask for it again. The application must set the iGroupId member of the LVITEM structure.

Return Value

None.

Remarks

A list-view control sends the LVN_GETDISPINFO message to retrieve item data stored by the application rather than the control. The data can be text or icon data for an item. It can also be item state data. See the LVM_SETCALLBACKMASK message for more information on implementing item state on a callback basis.

For more information on list-view callbacks, see Common Controls Reference.

Requirements

See Also

Reference

List-View Controls Notifications
List-View Controls Messages
WM_NOTIFY
LV_DISPINFO