The SetSystemCursor function replaces the contents of the system cursor specified by id with the contents of the cursor specified by hcur, and then destroys hcur. This function lets an application customize the system cursors.
BOOL SetSystemCursor (
| HCURSOR hcur, | // set specified system cursor to this cursor's contents, // then destroy this |
| DWORD id | // system cursor specified by its identifier |
| ); |
Parameters
hcur
Handle to a cursor. The function replaces the contents of the system cursor specified by id with the contents of the cursor handled by hcur. Then the function destroys hcur by calling DestroyCursor(hCursor).
id
A system cursor identifier. The function replaces the contents of this system cursor with the contents of the cursor handled by hcur.
Following is a list of system cursor identifiers:
| Value | Description |
| OCR_NORMAL | normal arrow cursor |
| OCR_IBEAM | I-beam cursor |
| OCR_WAIT | larger hourglass cursor |
| OCR_CROSS | crosshair cursor |
| OCR_UP | up arrow cursor |
| OCR_SIZE | size cursor |
| OCR_ICON | icon cursor |
| OCR_SIZENWSE | NW to SE sizing cursor |
| OCR_SIZENESW | NE to SW sizing cursor |
| OCR_SIZEWE | horizontal sizing cursor |
| OCR_SIZENS | vertical sizing cursor |
| OCR_SIZEALL | horizontal and vertical sizing cursor |
| OCR_SIZENO | international no symbol cursor |
| OCR_APPSTARTING | smaller hourglass with arrow cursor |
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
See Also