Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

typedef struct tag LV_DISPINFO {
  NMHDR 
hdr; 
  LVITEM 
item; 
} LV_DISPINFO;

Members

hdr

NMHDRstructure that contains information about this message.

item

LVITEMstructure that identifies the item or subitem. The structure either contains or receives information about the item. The maskmember contains a set of bit flags that specify which item attributes are relevant. It can be one or more of the following bit flags.

Value Description

LVIF_IMAGE

The iImagemember specifies, or is to receive, the index of the item's icon in the image list.

LVIF_STATE

The statemember specifies, or is to receive, the state of the item.

LVIF_TEXT

The pszTextmember 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 pszTextand cchTextMaxmembers 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 pszTextmember. 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 maskmember. 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.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also