CreateCursor
The CreateCursor
function creates a cursor having the specified size, bit patterns, and hot
spot.
HCURSOR CreateCursor(
|
HINSTANCE hInst, |
// handle to
application instance |
|
int xHotSpot, |
// horizontal
position of hot spot |
|
int yHotSpot, |
// vertical
position of hot spot |
|
int nWidth, |
// cursor width |
|
int nHeight, |
// cursor height |
|
CONST VOID *pvANDPlane, |
// pointer to AND
bitmask array |
|
CONST VOID *pvXORPlane |
// pointer to XOR
bitmask array |
|
); |
|
Parameters
hInst
Identifies
the current instance of the application creating the cursor.
xHotSpot
Specifies the
horizontal position of the cursor s hot spot.
yHotSpot
Specifies the
vertical position of the cursor s hot spot.
nWidth
Specifies the
width, in pixels, of the cursor.
nHeight
Specifies the
height, in pixels, of the cursor.
pvANDplane
Points to an
array of bytes that contains the bit values for the AND bitmask of the cursor,
as in a device-dependent monochrome bitmap.
pvXORplane
Points to an
array of bytes that contains the bit values for the XOR bitmask of the cursor,
as in a device-dependent monochrome bitmap.
Return Values
If the
function succeeds, the return value identifies the cursor.
If the
function fails, the return value is NULL. To get extended error information,
call GetLastError.
Remarks
The nWidth
and nHeight parameters must specify a width and height that are
supported by the current display driver, because the system cannot create
cursors of other sizes. To determine the width and height supported by the
display driver, use the GetSystemMetrics function, specifying the
SM_CXCURSOR or SM_CYCURSOR value.
Before
closing, an application must call the DestroyCursor function to free any
system resources associated with the cursor.
See Also