.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH CreateIcon 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBCreateIcon\fR (USER32.@)
.SH SYNOPSIS
HICON CreateIcon
 (
  HINSTANCE \fIhInstance\fR,
  INT       \fInWidth\fR,
  INT       \fInHeight\fR,
  BYTE      \fIbPlanes\fR,
  BYTE      \fIbBitsPixel\fR,
  LPCVOID   \fIlpANDbits\fR,
  LPCVOID   \fIlpXORbits\fR
 )

.SH PARAMS
\fIhInstance\fR \fB[In]\fR  the application's \fIhInstance\fR.
.PP
\fInWidth\fR \fB[In]\fR  the width of the provided bitmaps.
.PP
\fInHeight\fR \fB[In]\fR  the height of the provided bitmaps.
.PP
\fIbPlanes\fR \fB[In]\fR  the number of planes in the provided bitmaps.
.PP
\fIbBitsPixel\fR \fB[In]\fR  the number of bits per pixel of the \fIlpXORbits\fR bitmap.
.PP
\fIlpANDbits\fR \fB[In]\fR  a monochrome bitmap representing the icon's mask.
.PP
\fIlpXORbits\fR \fB[In]\fR  the icon\fB's '\fRcolor' bitmap.
.PP

.SH DESCRIPTION
.PP
Creates an icon based on the specified bitmaps. The bitmaps must be provided in a device dependent format and will be resized to (\fBSM_CXICON\fR,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. 
.PP
(*) Windows(tm) does not support 15bpp but it supports the \fB555\fR \fBRGB\fR 16bpp format!. 

.SH RETURNS
.PP
\fBSuccess:\fR handle to an icon 
.PP
\fBFailure:\fR \fBNULL\fR. 
.PP
\fBFIXME:\fR Do we need to resize the bitmaps? 

.SH IMPLEMENTATION
.PP
Declared in \fB"winuser.h"\fR. 
.PP
Implemented in \fB"dlls/user32/cursoricon.c"\fR. 
.PP
Debug channel \fB"cursor"\fR.