Share via

LV_DISPINFO

  • Article

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

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

Members

  • hdr
    NMHDR structure that contains information about this 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. It can be one or more of the following bit flags.

    Value Description
    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. 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

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

NMHDR | List-View Controls Structures

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.