CreateBitmap

【勇芳软件工作室】汉化HomePreviousNext

CreateBitmap函数创建一个具有指定宽度,高度和颜色格式(每个像素的颜色平面和位)的位图。

HBITMAP CreateBitmap(

INT 【nWidth】,//位图宽度,以像素为单位
INT 【nHeight参数】,//位图高度,以像素为单位
UINT 【// XOR位掩码中的平面数】,//设备使用的色平面数量
UINT 【cBitsPerPel】,//识别颜色所需的位数
CONST VOID *【lpvBits】//指向包含颜色数据的数组的指针
); 

参数

【nWidth】

指定位图宽度(以像素为单位)。

【nHeight参数】

指定位图高度(以像素为单位)。

【// XOR位掩码中的平面数】

指定设备使用的色平面数。

【cBitsPerPel】

指定识别单个像素颜色所需的位数。

【lpvBits】

指向一组颜色数据,用于设置像素矩形中的颜色。矩形中的每条扫描线必须是字对齐的(不是字对齐的扫描线必须用零填充)。如果此参数为NULL,则新位图未定义。

返回值

如果函数成功,则返回值是位图的句柄。

如果函数失败,返回值为NULL。

备注

创建位图后,可以通过调用SelectObject功能将其选择到设备上下文中。

虽然可以使用CreateBitmap功能来创建色彩位图,但出于性能原因,应用程序应使用CreateBitmap创建单色位图和CreateCompatibleBitmap来创建色彩位图。当从CreateBitmap返回的颜色位图被选择到设备上下文中时,Windows必须确保位图与正在选择的设备上下文的格式相匹配。由于CreateCompatibleBitmap使用设备上下文,因此返回与指定设备上下文相同格式的位图。因此,对SelectObject的后续调用比从CreateBitmap返回的颜色位图更快。

如果位图是单色的,则零表示前景色,一个表示目标设备上下文的背景颜色。

如果应用程序将【nWidth】【nHeight参数】参数设置为零,CreateBitmap将返回1到1像素的单色位图的句柄。

当您不再需要位图时,请调用DeleteObject功能将其删除。

也可以看看

CreateBitmapIndirect,CreateCompatibleBitmap,CreateDIBitmap, DeleteObject, GetBitmapBits, SelectObject, SetBitmapBits