Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro inserts a group into a list-view control. You can use this macro or send the LVM_INSERTGROUPmessage explicitly.

Syntax 

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

Parameters

hwnd

Handle to the list-view control.

index

Index of the item where the group is added.

pgrp

Pointer to an LVGROUP structure that contains the group to add.

Return Value

Returns the index of the item that the group was added to, or -1 if the operation failed.

Remarks

To turn on group mode, call LVM_ENABLEGROUPVIEWor ListView_EnableGroupView.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also