macro Header_InsertItem (commctrl.h)

Insère un nouvel élément dans un contrôle d’en-tête. Vous pouvez utiliser cette macro ou envoyer explicitement le message HDM_INSERTITEM.

Syntaxe

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

Paramètres

hwndHD

Type : HWND

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

i

Type : int

Index de l’élément après lequel le nouvel élément doit être inséré. Le nouvel élément est inséré à la fin du contrôle d’en-tête si i est supérieur ou égal au nombre d’éléments dans le contrôle. Si i est égal à zéro, le nouvel élément est inséré au début du contrôle d’en-tête.

phdi

Type : const LPHDITEM

Pointeur vers une structure HDITEM qui contient des informations sur le nouvel élément.

Valeur de retour

Type : int

Retourne l’index du nouvel élément en cas de réussite, ou -1 sinon.

Remarques

La macro Header_InsertItem est définie comme suit :

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

Exigences