WM_SETICON

This message is sent by an application to associate a new big or small icon with a window.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

WM_SETICON wParam = (WPARAM)(BOOL) fType;
lParam = (LPARAM)(HICON) hicon;

Parameters

fType

Specifies the type of icon being set. It is one of the following values:

Value Description
ICON_BIG Sets the large icon for the window.
ICON_SMALL Sets the small icon for the window.

hicon

Handle to the new large or small icon. If this parameter is NULL, the icon indicated by fType is removed.

Return Values

The return value is a handle to the previous large or small icon, depending on the value of fType. NULL indicates that the window previously had no icon of the type indicated by fType.

Default Action

The DefWindowProc function returns a handle to the previous large or small icon associated with the window, depending on the value of fType.

Remarks

Icons are stored per window class, not per window.

See Also

DefWindowProc, WM_GETICON