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 message requests that a tree view control's parent window provide information needed to display or sort an item. It is sent in the form of a WM_NOTIFYmessage.

Syntax 

TVN_GETDISPINFO 
lptvdi = (TV_DISPINFO FAR *) 
lParam

Parameters

lptvdi

Long pointer to a TV_DISPINFOstructure. The itemmember is a TVITEMstructure whose mask, hItem, state, and lParammembers specify the type of information required. You must fill the members of the structure with the appropriate information.

Return Value

The return value is ignored.

Remarks

This message is sent under the following circumstances:

  • If the pszTextmember of the item's TVITEMstructure is the LPSTR_TEXTCALLBACK value, the control sends this message to retrieve the item's text. In this case, the maskmember of lptvdiwill have the TVIF_TEXT flag set.

  • If the iImageor iSelectedImagemember of the item's TVITEMstructure is the I_IMAGECALLBACK value, the control sends this message to retrieve the index of an item's icons in the control's image list. In this case, if the item is selected, the maskmember of lptvdiwill have the TVIF_SELECTEDIMAGE flag set. If the item is not selected, the maskmember of lptvdiwill have the TVIF_IMAGE flag set.

  • If the cChildrenmember of the item's TVITEMstructure is the I_CHILDRENCALLBACK value, the control sends this message to retrieve a value that indicates whether the item has child items. In this case, the maskmember of lptvdiwill have the TVIF_CHILDREN flag set.

Requirements

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

See Also