CreateCompatibleBitmap

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

CreateCompatibleBitmap功能创建与与指定设备上下文关联的设备兼容的位图。

HBITMAP CreateCompatibleBitmap(

HDC 【HDC】,//处理设备上下文
INT 【nWidth】,//位图的宽度,以像素为单位
INT 【nHeight参数】//位图的高度,以像素为单位
); 

参数

【HDC】

标识设备上下文。

【nWidth】

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

【nHeight参数】

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

返回值

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

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

备注

CreateCompatibleBitmap功能创建的位图的颜色格式与由【HDC】参数标识的设备的颜色格式相匹配。该位图可以被选择到与原始设备兼容的任何存储设备上下文中。

因为存储器设备上下文允许彩色和单色位图,所以当指定的设备上下文是存储器设备上下文时,由CreateCompatibleBitmap函数返回的位图的格式不同。但是,为非内存设备上下文创建的兼容位图始终具有相同的颜色格式,并使用与指定设备上下文相同的调色板。

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

如果由CreateDIBSection函数创建的位图的DIB部分被选择到由【HDC】参数标识的设备上下文中,CreateCompatibleBitmap将创建一个DIB部分。

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

也可以看看

CreateDIBSection, DeleteObject, SelectObject