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:
Value | Meaning |
---|---|
|
Indicates that dwInputValue holds client coordinates of the pointer. |
|
Indicates that dwInputValue holds a divider index value. |
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
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | commctrl.h |