Prev Next

SetSystemCursor info  Overview  Group

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

DestroyCursor, LoadCursor, LoadCursorFromFile, SetCursor

See: