The LoadIcon function loads the specified icon resource from the executable (.EXE) file associated with an application instance. This function has been superseded by the LoadImage function
HICON LoadIcon(
HINSTANCE hInstance, // handle to application instance
LPCTSTR lpIconName // icon-name string or icon resource
// identifier
);
To use one of the predefined icons, set the hInstance parameter to NULL and the lpIconName parameter to one of the following values:
Value | Description |
---|---|
IDI_APPLICATION | Default application icon. |
IDI_ASTERISK | Same as IDI_INFORMATION. |
IDI_ERROR | Hand-shaped icon. |
IDI_EXCLAMATION | Same as IDI_WARNING. |
IDI_HAND | Same as IDI_ERROR. |
IDI_INFORMATION | Asterisk icon. |
IDI_QUESTION | Question mark icon. |
IDI_WARNING | Exclamation point icon. |
IDI_WINLOGO | Windows logo icon. |
If the function succeeds, the return value is a handle to the newly loaded icon.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
LoadIcon loads the icon resource only if it has not been loaded; otherwise, it retrieves a handle to the existing resource. The function searches the icon resource for the icon most appropriate for the current display. The icon resource can be a color or monochrome bitmap.
LoadIcon can only load an icon whose size conforms to the SM_CXICON and SM_CYICON system metric values. Use the LoadImage function to load icons of other sizes.
Windows CE: Predefined icons (IDI_*) are not supported.
In Windows CE 1.0, the icon must be a two bit per pixel (.ic2) icon or a monochrome icon.
Icons Overview, Icon Functions, CreateIcon, LoadImage, MAKEINTRESOURCE