macro Header_SetHotDivider (commctrl.h)

Modifica il colore di un divisore tra gli elementi dell'intestazione per indicare la destinazione di un'operazione di trascinamento della selezione esterna. È possibile utilizzare questa macro o inviare il messaggio di HDM_SETHOTDIVIDER in modo esplicito.

Sintassi

int Header_SetHotDivider(
   HWND  hwnd,
   BOOL  fPos,
   DWORD dw
);

Parametri

hwnd

Tipo: HWND

Handle di un controllo di intestazione.

fPos

Tipo: BOOL

Valore che specifica come deve essere interpretato dw. Il valore in questo campo può essere uno dei seguenti:

Valore	Significato
TRUE	Indica che dw contiene le coordinate client del puntatore.
false	Indica che dw contiene un valore di indice divisore.

dw

Tipo: DWORD

Il valore mantenuto qui viene interpretato a seconda del valore di fPos.

Se fPos è TRUE, dw rappresenta le coordinate client x e y del puntatore. La coordinata x si trova nella parola bassa e la coordinata y si trova nella parola alta. Al momento della ricezione del messaggio, il controllo intestazione evidenzia il divisore appropriato in base alle coordinate dw.

Se fPos è FALSE, dw rappresenta l'indice intero del divisore che verrà evidenziato.

Valore restituito

Tipo: int

Restituisce l'indice del divisore evidenziato dal controllo .

Osservazioni

Un controllo intestazione impostato sullo stile di HDS_DRAGDROP produce automaticamente questo effetto. Questo messaggio deve essere utilizzato quando il proprietario del controllo gestisce manualmente le operazioni di trascinamento della selezione.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h