Header_InsertItem

La macro Header_InsertItem inserta un ítem nuevo en un control de cabecera. Se puede usar esta macro o enviar explícitamente un mensaje HDM_INSERTITEM.

Definición

int Header_InsertItem(
    hwndHD, 	
    index, 	
    phdi	
   );

Descripción

hwndHD

Manipulador del control de cabecera.

index

Índice del ítem después del que se insertará el nuevo. El nuevo ítem es insertado al final del control de cabacera si el índice es mayor o igual que el número de ítems en el control. Si index es cero, el nuevo ítem es insertado al principio del control de cabecera.

phdi

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

Valores de retorno

Si la operación tiene éxito, el valor de retorno es el índice del nuevo ítem.

Si la operación falla, el valor de retorno es -1.

Observaciones

La macro Header_InsertItem está definida del modo siguiente:

#define Header_InsertItem(hwndHD, index, phdi) \
    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(index), \
    (LPARAM)(const HD_ITEM FAR*)(phdi))