The CreateIcon function creates an icon that has the specified size, colors, and bit patterns.
HICON CreateIcon(
| HINSTANCE hInstance, | // handle to application instance |
| int nWidth, | // icon width |
| int nHeight, | // icon height |
| BYTE cPlanes, | // number of planes in XOR bitmask |
| BYTE cBitsPixel, | // number of bits per pixel in XOR bitmask |
| CONST BYTE *lpbANDbits, | // pointer to AND bitmask array |
| CONST BYTE *lpbXORbits | // pointer to XOR bitmask array |
| ); |
Parameters
hInstance
Identifies the instance of the module creating the icon.
nWidth
Specifies the width, in pixels, of the icon.
nHeight
Specifies the height, in pixels, of the icon.
cPlanes
Specifies the number of planes in the XOR bitmask of the icon.
cBitsPixel
Specifies the number of bits per pixel in the XOR bitmask of the icon.
lpbANDbits
Points to an array of bytes that contains the bit values for the AND bitmask of the icon. This bitmask describes a monochrome bitmap.
lpbXORbits
Points to an array of bytes that contains the bit values for the XOR bitmask of the icon. This bitmask describes a monochrome or device-dependent color bitmap.
Return Values
If the function succeeds, the return value is the handle to an icon.
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 supported by the current display driver, because the system cannot create icons of other sizes. To determine the width and height supported by the display driver, use the GetSystemMetrics function, specifying the SM_CXICON or SM_CYICON value.
CreateIcon applies the following truth table to the AND and XOR bitmasks:
| AND bitmask | XOR bitmask | Display |
| 0 | 0 | Black |
| 0 | 1 | White |
| 1 | 0 | Screen |
| 1 | 1 | Reverse screen |
See Also