Returns drag & drop operation information in a SFTTREE_DRAGINFO structure.

C

LPSFTTREE_DRAGINFO WINAPI SftTree_GetDragInfo(HWND hwndCtl);
LPSFTTREE_DRAGINFO WINAPI SftTreeSplit_GetDragInfo(HWND hwndCtl);

C++

LPSFTTREE_DRAGINFO CSftTree::GetDragInfo() const;
LPSFTTREE_DRAGINFO CSftTreeSplit::GetDragInfo() const;

Parameters

hwndCtl

The window handle of the tree control.

Returns

The return value is a pointer to a SFTTREE_DRAGINFO structure.

Comments

The GetDragInfo function returns drag & drop operation information in a SFTTREE_DRAGINFO structure.

A tree control must be defined using the SFTTREESTYLE_DRAGDROP window style to support drag & drop.

The SFTTREE_DRAGINFO structure returned is only valid if the calling application is currently processing a SFTTREEN_BEGINDRAG, SFTTREEN_DRAGGING, SFTTREEN_ENDDRAG or SFTTREEN_CANCELDRAG notification.  When processing multiple notifications, the SFTTREE_DRAGINFO structure has to be retrieved using GetDragInfo every time.  The address of the retrieved SFTTREE_DRAGINFO structure cannot be considered valid after processing one notification.

Some fields in the structure may be modified if the application is currently processing a SFTTREEN_BEGINDRAG or SFTTREEN_DRAGGING notification. 

See Also  C/C++ API  |  Categories |  Notifications