Sets the attributes of the specified item in a header control. You can send this message explicitly or use the Header_SetItem macro.

Syntax

To send this message, call the SendMessage function as follows.

lResult = SendMessage(    // returns LRESULT in lResult
   hWndControl,           // (HWND) handle to destination control
   HDM_SETITEM,           // (UINT) message ID
   wParam,                // = (WPARAM)(int) iIndex; 
   lParam                 // = const (LPARAM)(LPHDITEM) phdItem;
);

Parameters

iIndex

The current index of the item whose attributes are to be changed.

phdItem

A pointer to an HDITEM structure that contains item information. When this message is sent, the mask member of the structure must be set to indicate which attributes are being set.

Return Value

Returns nonzero upon success, or zero otherwise.

Remarks

The HDITEM structure that supports this message supports item order and image list information. By using these members, you can control the order in which items are displayed and specify images to appear with items.

Message Information

Header	commctrl.h
Minimum operating systems	Windows NT 3.51, Windows 95