HDM_SETHOTDIVIDER (Compact 2013)

3/28/2014

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

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 Value

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.

Requirements

Header

commctrl.h

See Also

Reference

Header Controls Messages
Header_SetHotDivider