Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 SendMessagefunction 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

See Also