windows_programming_notes.nbk: Home | Index | Next Page: WM_GETMINMAXINFO | Previous Page: WM_GETHOTKEY

 WM_GETICON

The WM_GETICON message is 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.

Parameters

• wParam
Specifies the type of icon being retrieved. This parameter can be one of the following values.
• ICON_BIG
Retrieve the large icon for the window.
• ICON_SMALL
Retrieve the small icon for the window.
• ICON_SMALL2
Windows XP: 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

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.

Notification Requirements

• Minimum DLL Version None
• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 4.0

windows_programming_notes.nbk: Home | Index | Next Page: WM_GETMINMAXINFO | Previous Page: WM_GETHOTKEY

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time