HDM_SETITEM message

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

Parameters

wParam

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

lParam

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.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
HDM_SETITEMW (Unicode) and HDM_SETITEMA (ANSI)