【GDI】CBitmap::CreateBitmap

BOOL CreateBitmap(
    int nWidth,
    int nHeight,
    UINT nPlanes,
    UINT nBitcount,
    const void* lpBits);

参数

nWidth
指定位图的宽度（以像素为单位）。

nHeight
指定位图的高度（以像素为单位）。

nPlanes
指定位图中的颜色平面的数量。

nBitcount
指定每个显示像素的颜色位的数量。

lpBits
指向包含的初始位图位值的字节的数组。 如果为 NULL, 则不初始化新位图。

返回值

如果成功，则不为 0；否则为 0。

备注

对于颜色位图, 应将nPlanes或nBitcount参数设置为1。 如果这些参数均设为 1， CreateBitmap 则会创建一个单色位图。

尽管无法为显示设备直接选择位图，但可以使用 CDC::SelectObject 选择将它作为“内存设备上下文”的当前位图，并使用 CDC::BitBlt 函数将其复制到任何兼容的设备上下文中。

完成通过 CBitmap 函数创建的 CreateBitmap 对象后，首先选择设备上下文中的位图，然后删除 CBitmap 对象。

有关详细信息, 请参阅bmBits BITMAP结构中的字段的说明。 BITMAP 结构根据 CBitmap::CreateBitmapIndirect 成员函数进行说明。