This structure contains and retrieves information about a tree view item.
At a Glance
Header file: | Commctrl.h |
Windows CE versions: | 1.0 and later |
Syntax
typedef struct _TV_DISPINFO {
NMHDR hdr;
TV_ITEM item;
} TV_DISPINFO;
Members
hdr
NMHDR structure that contains information about this notification message.
item
TV_ITEM structure that identifies and contains information about the tree view item. The mask member of the TV_ITEM structure specifies which information is being set or retrieved. It can be one or more of the following values:
Value | Description |
TVIF_CHILDREN | The cChildren member specifies, or is to receive, a value that indicates whether the item has child items. |
TVIF_IMAGE | The iImage member specifies, or is to receive, the index of the item’s nonselected icon in the image list. |
TVIF_SELECTEDIMAGE | The iSelectedImage member specifies, or is to receive, the index of the item’s selected icon in the image list. |
TVIF_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, you typically copy the text to the buffer pointed to by the pszText member of the TV_ITEM structure. However, you can return a string in the pszText member instead. If you do so, you cannot change or delete the string until the corresponding item text is deleted or until two additional TVN_GETDISPINFO notification messages have been sent. |
See Also