Header_SetHotDivider macro

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


int Header_SetHotDivider(
  HWND hwndHD,
  BOOL flag,
  DWORD dwInputValue
);

Parameters

hwndHD

Type: HWND

A handle to a header control.

flag

Type: BOOL

A value specifying how dwInputValue is to be interpreted. The value in this field can be one of the following:

ValueMeaning
TRUE

Indicates that dwInputValue holds client coordinates of the pointer.

FALSE

Indicates that dwInputValue holds a divider index value.

 

dwInputValue

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

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft