DropHighlightStyle


	DropHighlightStyle	Softel vdm, Inc.

Defines the display attribute of the current drag & drop target item.

DWORD WINAPI SftTree_GetDropHighlightStyle(HWND hwndCtl);
void WINAPI SftTree_SetDropHighlightStyle(HWND hwndCtl, DWORD style);
DWORD WINAPI SftTreeSplit_GetDropHighlightStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetDropHighlightStyle(HWND hwndCtl, DWORD style);

C++

DWORD CSftTree::GetDropHighlightStyle() const;
void CSftTree::SetDropHighlightStyle(DWORD style);
DWORD CSftTreeSplit::GetDropHighlightStyle() const;
void CSftTreeSplit::SetDropHighlightStyle(DWORD style);

Parameters

hwndCtl

The window handle of the tree control.

style

A value describing the drop target display method used for the current drag & drop target defined using SetDropHighlight:

SFTTREE_DROPHIGHLIGHT_CARET

The drop target is the current item (GetCaretIndex). The current item is updated by each call to SetDropHighlight. The drop target becomes the new current item. The target item is not selected, so even in a single selection tree control (see SFTTREESTYLE_MULTIPLESEL) index numbers returned by GetCaretIndex and GetCurSel are not identical.

SFTTREE_DROPHIGHLIGHT_ONTOP

The drag & drop target is highlighted using the color defined by the SFTTREE_COLORS structure member colorDropHighlight (see SetCtlColors). The color is used as background color for the target item. The current item is not updated.

SFTTREE_DROPHIGHLIGHT_BETWEEN

The drag & drop target is highlighted using a solid line drawn using the color defined by the SFTTREE_COLORS structure member colorDropHighlight (see SetCtlColors). The line is drawn before the target item, interpreting the value returned by GetDropHighlight as the insertion point.

Returns

GetDropHighlightStyle returns a value indicating the current drop target display method.

Comments

The GetDropHighlightStyle and SetDropHighlightStyle functions define the display attribute of the current drag & drop target item.

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

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

SFTTREE_DROPHIGHLIGHT_CARET	The drop target is the current item (GetCaretIndex). The current item is updated by each call to SetDropHighlight. The drop target becomes the new current item. The target item is not selected, so even in a single selection tree control (see SFTTREESTYLE_MULTIPLESEL) index numbers returned by GetCaretIndex and GetCurSel are not identical.
SFTTREE_DROPHIGHLIGHT_ONTOP	The drag & drop target is highlighted using the color defined by the SFTTREE_COLORS structure member colorDropHighlight (see SetCtlColors). The color is used as background color for the target item. The current item is not updated.
SFTTREE_DROPHIGHLIGHT_BETWEEN	The drag & drop target is highlighted using a solid line drawn using the color defined by the SFTTREE_COLORS structure member colorDropHighlight (see SetCtlColors). The line is drawn before the target item, interpreting the value returned by GetDropHighlight as the insertion point.