WM_GETICON message

Sent to a window to retrieve a handle to the large or small icon associated with a window. The system displays the large icon in the ALT+TAB dialog, and the small icon in the window caption.

A window receives this message through its WindowProc function.

#define WM_GETICON                      0x007F

Parameters

wParam

The type of icon being retrieved. This parameter can be one of the following values.

Value	Meaning
ICON_BIG 1	Retrieve the large icon for the window.
ICON_SMALL 0	Retrieve the small icon for the window.
ICON_SMALL2 2	Retrieves the small icon provided by the application. If the application does not provide one, the system uses the system-generated icon for that window.

 

lParam

This parameter is not used.

Return value

Type: HICON

The return value is a handle to the large or small icon, depending on the value of wParam. When an application receives this message, it can return a handle to a large or small icon, or pass the message to the DefWindowProc function.

Remarks

When an application receives this message, it can return a handle to a large or small icon, or pass the message to DefWindowProc.

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

Requirements

See also

Reference

DefWindowProc

WM_SETICON

Conceptual

Windows

Send comments about this topic to Microsoft

Build date: 2/25/2013