SetSystemCursor
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, |
|
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 DestroyCursor1C3KRCH(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