please dont rip this site Prev Next

LoadCursor info  Overview  Group

The LoadCursor function loads the specified cursor resource from the executable (.EXE) file associated with an application instance. This function has been superseded by the LoadImage function

HCURSOR LoadCursor(

    HINSTANCE hInstance,

// handle of application instance

    LPCTSTR lpCursorName 

// name string or cursor resource identifier



Identifies an instance of the module whose executable file contains the cursor to be loaded.
Points to a null-terminated string that contains the name of the cursor resource to be loaded. Alternatively, this parameter can consist of the resource identifier in the low-order word and zero in the high-order word. The MAKEINTRESOURCE macro can also be used to create this value.

To use one of the Win32 predefined cursors, the application must set the hInstance parameter to NULL and the lpCursorName parameter to one the following values:




Standard arrow and small hourglass


Standard arrow




Text I-beam


Obsolete for applications marked version 4.0 or later.


Slashed circle


Obsolete for applications marked version 4.0 or later. Use IDC_SIZEALL.


Four-pointed arrow


Double-pointed arrow pointing northeast and southwest


Double-pointed arrow pointing north and south


Double-pointed arrow pointing northwest and southeast


Double-pointed arrow pointing west and east


Vertical arrow



Return Values

If the function succeeds, the return value is the handle of the newly loaded cursor.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.


LoadCursor only loads the cursor resource if it has not been loaded; otherwise, it retrieves the handle of the existing resource. This function returns a valid cursor handle only if the lpCursorName parameter points to a cursor resource. If lpCursorName points to any type of resource other than a cursor (such as an icon), the return value is not NULL, even though it is not a valid cursor handle.

The LoadCursor function searches the cursor resource most appropriate for the cursor for the current display device. The cursor resource can be a color or monochrome bitmap.

See Also

LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor 

file: /Techref/os/win/api/win32/func/src/f53_10.htm, 7KB, , updated: 2001/6/25 07:30, local time: 2024/4/18 10:38,

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF=""> LoadCursor</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.

Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.

Welcome to!