LV_DISPINFO info  Overview  Group

The LV_DISPINFO structure contains information needed to display an owner-drawn item in a list view control.

typedef struct tagLV_DISPINFO { 

    NMHDR   hdr; 

    LV_ITEM item; 

} LV_DISPINFO; 

 

Members

hdr

Specifies a NMHDR structure. The code member of this structure identifies the notification message being sent. It can be one of the following notification codes: LVN_GETDISPINFO or LVN_SETDISPINFO.

item

Specifies an LV_ITEM structure that identifies the item or subitem. The structure either contains or receives information about the item. The mask member contains a set of bit flags that specify which item attributes are relevant. You can set one or more of the following bit flags:

Value	Meaning
LVIF_IMAGE	The iImage member specifies, or is to receive, the index of the item’s icon in the image list.
LVIF_STATE	The state member specifies, or is to receive, the state of the item.
LVIF_TEXT	The pszText member specifies the new item text or the address of a buffer that is to receive the item text.

If the structure is receiving item text, the pszText and cchTextMax members specify the address and size of a buffer. You can either copy text to the buffer or assign the address of a string to the pszText member. In the latter case, you must not change or delete the string until the corresponding item text is deleted or two additional LVN_GETDISPINFO messages have been sent.

If you are handling the LVN_GETDISPINFO message, you can set the LVIF_DI_SETITEM flag in the mask member. This tells the operating system to store the requested list item information, and not ask for it again.

Remarks

When a list view control sends the LVN_GETDISPINFO or LVN_SETDISPINFO notification codes, it passes a pointer to an LV_DISPINFO structure as the lParam parameter of a WM_NOTIFY message.

See Also

LV_ITEM, LVN_GETDISPINFO, LVN_SETDISPINFO, WM_NOTIFY