SB_SETICON
A version of this page is also available for
4/8/2010
This message sets the icon for a part in a status bar. To send this message, call the SendMessage function as follows.
Syntax
lResult = SendMessage(
(HWND) hWndControl,
(UINT) SB_SETICON,
(WPARAM) wParam, // = (WPARAM) (INT) iPart;
(LPARAM) lParam // = (LPARAM) (HICON) hIcon;
);
Parameters
- iPart
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.
- hIcon
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
| Header | commctrl.h |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |