Export (0) Print
Expand All
1 out of 3 rated this helpful - Rate this topic

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.

ValueMeaning
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

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_SETICON
Conceptual
Windows

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.