Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

TVN_GETDISPINFO notification code

Requests that a tree-view control's parent window provide information needed to display or sort an item. This notification code is sent in the form of a WM_NOTIFY message.


TVN_GETDISPINFO 

    lptvdi = (LPNMTVDISPINFO) lParam 

Parameters

lParam

Pointer to an NMTVDISPINFO 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 notification code 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 notification code to retrieve the item's text. In this case, the mask member of lParam 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 notification code 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 lParam will have the TVIF_SELECTEDIMAGE flag set. If the item is not selected, the mask member of lParam 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 notification code to retrieve a value that indicates whether the item has child items. In this case, the mask member of lParam will have the TVIF_CHILDREN flag set.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

TVN_GETDISPINFOW (Unicode) and TVN_GETDISPINFOA (ANSI)

See also

TVN_SETDISPINFO

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.