CBitmap::CreateCompatibleBitmap

[アーティクル]
08/09/2011

pDC で指定されたデバイスと互換性のあるビットマップを初期化します。

BOOL CreateCompatibleBitmap(
   CDC* pDC,
   int nWidth,
   int nHeight 
);

パラメーター

pDC
デバイスコンテキスト。
nWidth
ビットマップの幅 (ピクセル数)。
nHeight
ビットマップの高さ (ピクセル数)。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このビットマップは、指定したデバイスコンテキストと同数のカラープレーンを持つか、またはピクセルあたり同じビット数の形式を持つことになります。作成されたビットマップは、pDC により指定されたデバイスコンテキストと互換性のある任意のメモリデバイスの現在のビットマップとして選択できます。

pDC がメモリデバイスコンテキストの場合、返されるビットマップは、デバイスコンテキストに現在選択されているビットマップと同じ形式を持つことになります。 "メモリデバイスコンテキスト" は、ディスプレイ表示面を表すメモリブロックです。メモリデバイスコンテキストを使って、互換性のあるデバイスの実際のディスプレイ表示面にコピーするためのイメージをメモリ内に準備します。

メモリデバイスコンテキストが作成されると、GDI はメモリデバイスコンテキスト用のモノクロのストックビットマップを自動的に選択します。

カラーのメモリデバイスコンテキストは、モノクロのビットマップもカラーのビットマップも選択できるため、CreateCompatibleBitmap 関数が返すビットマップの形式はいつも同じとは限りません。メモリデバイスコンテキスト以外のデバイス互換性ビットマップの形式は、常にそのデバイスの形式になります。

CreateCompatibleBitmap 関数によって作成された CBitmap オブジェクトの処理が終了したら、まずデバイスコンテキストからビットマップの選択を外し、次に CBitmap オブジェクトを削除します。