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

To send this message, call the SendMessagefunction.

Syntax 

lResult = SendMessage(
   (HWND) hWndControl,
   (UINT) LVM_INSERTGROUP,
   (WPARAM) wParam,  // = (WPARAM) (int) 
index;
   (LPARAM) lParam	// = (LPARAM) (PLVGROUP) 
pgrp;
);

Parameters

index

Index where the group is to be added. If this is -1, the group is added at the end of the list.

pgrp

Pointer to a LVGROUPstructure 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.

A group cannot be inserted into an empty ListView control.

Requirements

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

See Also