macro Header_InsertItem (commctrl.h)

Inserta un nuevo elemento en un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_INSERTITEM explícitamente.

Sintaxis

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

Parámetros

hwndHD

Tipo: HWND

Identificador del control de encabezado.

i

Tipo: int

Índice del elemento después del cual se va a insertar el nuevo elemento. El nuevo elemento se inserta al final del control de encabezado si i es mayor o igual que el número de elementos del control. Si i es cero, el nuevo elemento se inserta al principio del control de encabezado.

phdi

Tipo: const LPHDITEM

Puntero a una estructura HDITEM que contiene información sobre el nuevo elemento.

Valor devuelto

Tipo: int

Devuelve el índice del nuevo elemento si se ejecuta correctamente o -1 de lo contrario.

Observaciones

La macro Header_InsertItem se define de la siguiente manera:

#define Header_InsertItem(hwndHD, i, phdi) \

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

    (LPARAM)(const LPHDITEM)(phdi))

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h