CWinApp::LoadIcon

HICON LoadIcon( LPCTSTR lpszResourceName ) const;

HICON LoadIcon( UINT nIDResource ) const;

Return Value

A handle to an icon if successful; otherwise NULL.

Parameters

lpszResourceName

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

nIDResource

ID number of the icon resource.

Remarks

Loads the icon resource named by lpszResourceName or specified by nIDResource from the executable file. 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   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.

CWinApp OverviewClass MembersHierarchy Chart

See Also   CWinApp::LoadStandardIcon, CWinApp::LoadOEMIcon, ::LoadIcon