CreateIcon() and CreateCursor() Documentation Incomplete

ID Number: Q68988

3.00

WINDOWS

docerr

Summary:

The documentation for the CreateCursor() and CreateIcon() functions in

chapter 4 of the "Microsoft Windows Software Development Kit Reference

Volume 1" is not complete. These functions must only be used to create

cursors and icons in the dimensions supported by the current display

driver.

The GetSystemMetrics() function provides the supported dimensions to

an application. To determine the proper width and height of an icon,

use the SM_CXICON and SM_CYICON parameters, respectively. To determine

the proper width and height of a cursor, use the SM_CXCURSOR and

SM_CYCURSOR parameters, respectively. For more information on

GetSystemMetrics(), see page 4-212 of the SDK reference manual.

Creating a cursor or icon that has an unsupported size can terminate

the application with an unrecoverable application error (UAE).