LV_DISPINFO
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