共用方式為


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 );

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

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

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

範例

如需範例,請參閱 調整影像

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

點陣圖函式

位圖概觀

CreateDIBSection

DeleteObject

SelectObject