commctrl.h


Header_SetHotDivider

Cambia el color de un divisor entre ítems de un control de cabecera para indicar el destino de una operación de drag-and-drop externa. Se puede usar esta macro o enviar un mensaje HDM_SETHOTDIVIDER explícitamente.

Definición

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

Descripción

hwndHD
Manipulador del control de cabecera.
flag

Un valor que especifica como se debe interpretar dwInputValue. El valor en este campo puede tomar uno de los valores siguientes:

ValorSignificado
TRUEIndica que dwInputValue contiene coordenadas de cliente del puntero.
FALSEIndica que dwInputValue contiene un valor de índice de un divisor.
dwInputValue

El valor contenido aqui se interpreta dependiendo del valor de flag.

Si flag es TRUE, dwInputValue representa las coordenadas de cliente x e y del puntero. La coordenada x en la palabra de menor peso, y la y en la de mayor peso. Al recibir el mensaje, el control de cabecera resalta el divisór apropiado basándose en las coordenadas contenidas en dwInputValue.

Si flag es FALSE, dwInputValue representa el índice entero del divisor que debe ser resaltado.

Valores de retorno

Devuelve el índice del divisor que el control ha resaltado.

Observaciones

Un control de cabecera con el estilo HDS_DRAGDROP produce este mismo efecto automáticamente. Este mensaje esta pensado para se usado cuando la ventana propietaria del control manipula las operaciones de drag-and-drop manualmente.

La macro Header_SetHotDivider está definida del modo siguiente:

#define Header_SetHotDivider(hwnd, fPos, dw) \
        (int)SNDMSG((hwnd), HDM_SETHOTDIVIDER, (WPARAM)(fPos), (LPARAM)(dw))