SB_SETICON message

Sets the icon for a part in a status bar.

Parameters

wParam

Zero-based index of the part that will receive the icon. If this parameter is -1, the status bar is assumed to be a simple status bar.

lParam

Handle to the icon to be set. If this value is NULL, the icon is removed from the part.

Return value

Returns nonzero if successful, or zero otherwise.

Remarks

The status bar will not destroy the icon. It is the calling application's responsibility to keep track of and destroy any icons.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h