Share via


CWinApp::LoadCursor

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

HCURSOR LoadCursor( 
   LPCTSTR lpszResourceName  
) const; 
HCURSOR LoadCursor( 
   UINT nIDResource  
) const;

Parameters

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

  • nIDResource
    ID of the cursor resource. For a list of resources, see LoadCursor in the Windows SDK.

Return Value

A handle to a cursor if successful; otherwise NULL.

Remarks

LoadCursor loads the cursor into memory only if it has not been previously loaded; otherwise, it retrieves a handle of the existing resource.

Use the LoadStandardCursor or LoadOEMCursor member function to access the predefined Windows cursors.

Example

HCURSOR hCursor;

// Load a cursor resource that was originally created using 
// the Graphics Editor and assigned the i.d. IDC_MYCURSOR.
hCursor = AfxGetApp()->LoadCursor(IDC_MYCURSOR);

Requirements

Header: afxwin.h

See Also

Reference

CWinApp Class

Hierarchy Chart

CWinApp::LoadStandardCursor

CWinApp::LoadOEMCursor

LoadCursor