【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 成員函數進行說明。