This macro changes the color of a divider 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 message: | HDM_SETHOTDIVIDER |
Syntax
int Header_SetHotDivider(HWND hwndHD, BOOL flag,
DWORD dwInputValue);
Parameters
hwndHD
Handle to a header control.
flag
Boolean value that specifies how dwInputValue is to be interpreted.
dwInputValue
Value held here is interpreted depending on the value of flag.
If flag is TRUE, then dwInputValue 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 dwInputValue coordinates.
If flag is FALSE, then dwInputValue represents the integer index of the divider that will be highlighted.
Return Values
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.