Compartir a través de


TVN_GETDISPINFO (Compact 2013)

3/28/2014

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_NOTIFY message.

Syntax

TVN_GETDISPINFO lptvdi = (TV_DISPINFO FAR *) lParam

Parameters

  • lptvdi
    Long pointer to a TV_DISPINFO structure. The item member is a TVITEM structure whose mask, hItem, state, and lParam members 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 pszText member of the item's TVITEM structure is the LPSTR_TEXTCALLBACK value, the control sends this message to retrieve the item's text. In this case, the mask member of lptvdi will have the TVIF_TEXT flag set.
  • If the iImage or iSelectedImage member of the item's TVITEM structure 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 mask member of lptvdi will have the TVIF_SELECTEDIMAGE flag set. If the item is not selected, the mask member of lptvdi will have the TVIF_IMAGE flag set.
  • If the cChildren member of the item's TVITEM structure 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 mask member of lptvdi will have the TVIF_CHILDREN flag set.

Requirements

Header

commctrl.h

See Also

Reference

Tree View Controls Notifications
TV_DISPINFO
TVN_SETDISPINFO
WM_NOTIFY