windows_programming_notes.nbk: Home | Index | Next Page: LVCOLUMN | Previous Page: LOGBRUSH
LPNMLVDISPINFO
typedef struct tagLVDISPINFO {
NMHDR hdr;
LVITEM item;
} NMLVDISPINFO, FAR *LPNMLVDISPINFO;
Members
- hdr
NMHDR structure that contains information about this notification
message.
- item
LVITEM 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:
LVIF_DI_SETITEM Set this flag when processing LVN_GETDISPINFO, so the listview control will retain the supplied information and not request it again.
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 LVITEM 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 of the LVITEM structure. This tells the operating system to store the requested list item information and not ask for it again. For list-view controls with the LVS_REPORT style, this flag only applies to the first (subitem 0) column's information. The control will not store information for subitems.
windows_programming_notes.nbk: Home | Index | Next Page: LVCOLUMN | Previous Page: LOGBRUSH
Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time