Share via


Header_SetHotDivider (Compact 2013)

3/28/2014

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

Syntax

#define Header_SetHotDivider(hwnd, fPos, dw) \
        (int)SNDMSG((hwnd), HDM_SETHOTDIVIDER, (WPARAM)fPos, (LPARAM)dw)

Parameters

  • hwnd
    Handle to a header control.
  • fPos
    Boolean value that specifies how dw is to be interpreted.
  • dw
    Value held here is interpreted depending on the value of fPos.

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

    If fPos is FALSE, then dw represents the integer index of the divider that will be highlighted.

Return Value

Returns the index of the divider that the control highlighted.

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

Header

commctrl.h

See Also

Reference

Header Controls Macros
HDM_SETHOTDIVIDER