macro Header_SetHotDivider (commctrl.h)

Modifie la couleur d’un séparateur entre les éléments d’en-tête pour indiquer la destination d’une opération de glisser-déplacer externe. Vous pouvez utiliser cette macro ou envoyer explicitement le message HDM_SETHOTDIVIDER.

Syntaxe

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

Paramètres

hwnd

Type : HWND

Handle vers un contrôle d’en-tête.

fPos

Type : BOOL

Valeur spécifiant la façon dont dw doit être interprétée. La valeur de ce champ peut être l’une des suivantes :

Valeur	Signification
TRUE	Indique que contient les coordonnées client du pointeur.
FALSE	Indique que contient une valeur d’index de diviseur.

dw

Type : DWORD

La valeur détenue ici est interprétée en fonction de la valeur de fPos.

Si fPos est TRUE, dw représente les coordonnées du client x et y du pointeur. La coordonnée x se trouve dans le mot bas, et la coordonnée y se trouve dans le mot haut. Lors de la réception du message, le contrôle d’en-tête met en surbrillance le séparateur approprié en fonction des coordonnées dw.

Si fPos est FALSE, dw représente l’index entier du séparateur qui sera mis en surbrillance.

Valeur de retour

Type : int

Retourne l’index du diviseur mis en surbrillance par le contrôle.

Remarques

Un contrôle d’en-tête défini sur le style HDS_DRAGDROP produit automatiquement cet effet. Ce message est destiné à être utilisé lorsque le propriétaire des poignées de contrôle effectue des opérations de glisser-déplacer manuellement.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h