CreateIcon(3w)

NAME

CreateIcon (USER32.@)

SYNOPSIS

HICON CreateIcon
 (
  HINSTANCE hInstance,
  INT       nWidth,
  INT       nHeight,
  BYTE      bPlanes,
  BYTE      bBitsPixel,
  LPCVOID   lpANDbits,
  LPCVOID   lpXORbits
 )

PARAMS

hInstance [In] the application's hInstance.

nWidth [In] the width of the provided bitmaps.

nHeight [In] the height of the provided bitmaps.

bPlanes [In] the number of planes in the provided bitmaps.

bBitsPixel [In] the number of bits per pixel of the lpXORbits bitmap.

lpANDbits [In] a monochrome bitmap representing the icon's mask.

lpXORbits [In] the icon's 'color' bitmap.

DESCRIPTION

Creates an icon based on the specified bitmaps. The bitmaps must be provided in a device dependent format and will be resized to (SM_CXICON,SM_CYICON) and depth converted to match the screen's color depth. The provided bitmaps must be top-down bitmaps. Although Windows(tm) does not support 15bpp(*) this Api must support it for Winelib applications.

(*) Windows(tm) does not support 15bpp but it supports the 555 RGB 16bpp format!.

RETURNS

Success: handle to an icon

Failure: NULL.

FIXME: Do we need to resize the bitmaps?

IMPLEMENTATION

Defined in "winuser.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/user32/cursoricon.c".

Debug channel "cursor".

Wine API Aug 2010 CreateIcon(3w)