HDM_INSERTITEM

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message inserts a new item into a header control. You can send this message explicitly or use the Header_InsertItem macro.

Syntax

HDM_INSERTITEM wParam = (WPARAM)(int) index;
    lParam = (LPARAM)(const HD_ITEM FAR*) phdi;

Parameters

  • index
    Index of the item after which the new item is inserted. The new item is inserted at the end of the header control if index is greater than or equal to the number of items in the control. If index is zero, the new item is inserted at the beginning of the header control.
  • phdi
    Pointer to an HDITEM structure that contains data about the new item.

Return Value

The index of the new item indicates success. –1 indicates failure.

Requirements

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

See Also

Reference

Header Controls Messages
Header_InsertItem
HDITEM