commctrl.h

Mensaje LVM_INSERTGROUP

Definición

LVM_INSERTGROUP
    index=(WPARAM)(int)wParam
    pgrp=(LPARAM)(PLVGROUP)lParam

Inserta un grupo en un control list-view. Se puede enviar este mensaje explícitamente o bien usar la macro ListView_InsertGroup.

Descripción

index
Índice donde el grupo será añadido. Si el valor es -1, el grupo será añadido al final de la lista.
pgrp
Puntero a una estructura LVGROUP que contiene el grupo a añadir.

Valor de retorno

Devuelve el índice del ítem al que se ha añadido el grupo, o -1 si la operación ha fallado.

Observaciones

Para cambiar al modo de grupo, usar el mensaje LVM_ENABLEGROUPVIEW o la macro ListView_EnableGroupView.

Un grupo no puede ser insertado en un control list-view vacío.

Hay que asegurarse de que se asigna a iGroupId al item o ítems al que se añadió el grupo. En caso contrario, después de que LVM_ENABLEGROUPVIEW se procese con valor TRUE, el control list-view no mostrará ningún ítem.

Para usar ListView_InsertGroup se debe especificar la versión 6 de Comctl32.dll en el manifiesto.