commctrl.h

Macro ListView_InsertGroup

Inserta un grupo en un control list-view. Se puede usar esta macro o enviar el mensaje LVM_INSERTGROUP explícitamente.

Definición

int ListView_InsertGroup(
    HWND hwnd,
    int index,
    PLVGROUP pgrp
);

Descripción

hwnd
Un manipulador del control list-view.
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.