Header_SetHotDivider

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

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.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

HDM_SETHOTDIVIDER

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.