Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Collapse the table of content
Expand the table of content


Loads the icon resource named by lpszResourceName or specified by nIDResource from the executable file.

HICON LoadIcon( 
   LPCTSTR lpszResourceName  
) const; 
HICON LoadIcon( 
   UINT nIDResource  
) const;


Points to a null-terminated string that contains the name of the icon resource. You can also use a CString for this argument.


ID number of the icon resource.

A handle to an icon if successful; otherwise NULL.

LoadIcon loads the icon only if it has not been previously loaded; otherwise, it retrieves a handle of the existing resource.

You can use the LoadStandardIcon or LoadOEMIcon member function to access the predefined Windows icons.

Note Note

This member function calls the Win32 API function LoadIcon, which can only load an icon whose size conforms to the SM_CXICON and SM_CYICON system metric values.

Header: afxwin.h

© 2015 Microsoft