CreateCompatibleBitmap 函式 (wingdi.h)

CreateCompatibleBitmap 函式會建立與指定裝置內容相關聯的裝置相容的點陣圖。

語法

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

[in] hdc

裝置內容的控制代碼。

[in] cx

位圖寬度，以像素為單位。

[in] cy

位圖高度，以像素為單位。

如果函式成功，則傳回值是相容位圖的句柄， (DDB) 。

如果函式失敗，則傳回值為 NULL。

CreateCompatibleBitmap 函式所建立之位圖的色彩格式符合 hdc 參數所識別之裝置的色彩格式。此位圖可以選取至與原始裝置相容的任何記憶體裝置內容中。

因為記憶體裝置內容同時允許色彩和單色位圖，所以當指定的裝置內容是記憶體裝置內容時， CreateCompatibleBitmap 函式所傳回的點陣圖格式會有所不同。不過，針對非記憶體裝置內容所建立的相容位圖一律擁有相同的色彩格式，並使用與指定裝置內容相同的調色盤。

注意：建立記憶體裝置內容時，它一開始會選取一對一的單色位圖。如果這個記憶體裝置內容用於 CreateCompatibleBitmap，則建立的點陣圖是單色位圖。若要建立色彩點陣圖，請使用用來建立記憶體裝置內容的 HDC ，如下列程式代碼所示：


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

如果應用程式將 nWidth 或 nHeight 參數設定為零， CreateCompatibleBitmap 會將句柄傳回至 1-by-1 像素的單色位圖。

如果 DIB 區段是 CreateDIBSection 函式所建立的位陣圖，則會選取 到 hdc 參數所識別的裝置內容中， CreateCompatibleBitmap 會建立 DIB 區段。

當您不再需要位圖時，請呼叫 DeleteObject 函式來刪除它。

如需範例，請參閱調整影像。