次の方法で共有


CBitmap::CreateCompatibleBitmap

更新 : 2007 年 11 月

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

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

パラメータ

  • pDC
    デバイス コンテキスト。

  • nWidth
    ビットマップの幅 (ピクセル数)。

  • nHeight
    ビットマップの高さ (ピクセル数)。

戻り値

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

解説

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

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

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

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

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

必要条件

ヘッダー : afxwin.h

参照

参照

CBitmap クラス

階層図

CreateCompatibleBitmap

CGdiObject::DeleteObject

その他の技術情報

CBitmap のメンバ