HDM_SETHOTDIVIDER

This message changes the divider color between header items to indicate the destination of an external drag-and-drop operation.

At a Glance

Header file: Commctrl.h
Windows CE versions: 2.0 and later
Related macro: Header_SetHotDivider

Syntax

HDM_SETHOTDIVIDER wParam = (WPARAM) flag;
lParam = (LPARAM) dwInputValue;

Parameters

flag

Specifies the type of value represented by dwInputValue. It is one of the following values:

Value Description
TRUE Indicates that dwInputValue holds the client coordinates of the pointer
FALSE Indicates that dwInputValue holds a divider index value

dwInputValue

Value held in dwInputValue is interpreted based upon the value of flag.

If flag is TRUE, dwInputValue represents the x- and y-coordinates of the pointer. The x-coordinate is in the low-order word, and the y-coordinate is in the high-order word. When the header control receives the message, it highlights the appropriate divider based on the dwInputValue coordinates.

If flag is FALSE, dwInputValue represents the integer index of the divider highlighted.

Return Values

Returns a value equal to the index of the divider that the control highlighted

Remarks

This message creates an effect that a header control automatically produces when it has the HDS_DRAGDROP style. The HDM_SETHOTDIVIDER message is intended for use when the owner of the control manually handles drag-and-drop operations.