WM_SETICON message

Associates a new large or small icon with a window. The system displays the large icon in the ALT+TAB dialog box, and the small icon in the window caption.

#define WM_SETICON                      0x0080

Parameters

wParam

The type of icon to be set. This parameter can be one of the following values.

Value Meaning
ICON_BIG
1
Set the large icon for the window.
ICON_SMALL
0
Set the small icon for the window.

 

lParam

A handle to the new large or small icon. If this parameter is NULL, the icon indicated by wParam is removed.

Return value

Type: LRESULT

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

Remarks

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

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Winuser.h (include Windows.h)

See also

Reference

DefWindowProc

WM_GETICON

Conceptual

Windows