Header_SetHotDivider macro (commctrl.h)

Changes the color of a divider between header items to indicate the destination of an external drag-and-drop operation. You can use this macro or send the HDM_SETHOTDIVIDER message explicitly.

Syntax

void Header_SetHotDivider(
   hwnd,
   fPos,
   dw
);

Parameters

hwnd

Type: HWND

A handle to a header control.

fPos

Type: BOOL

A value specifying how dwInputValue is to be interpreted. The value in this field can be one of the following:

dw

Type: DWORD

The value held here is interpreted depending on the value of flag.

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

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

Return value

None

Remarks

A header control set to the HDS_DRAGDROP style produces this effect automatically. This message is intended to be used when the owner of the control handles drag-and-drop operations manually.

Requirements