CDC::CreateCompatibleDC

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

pDC により指定されるデバイスと互換性のあるメモリデバイスコンテキストを作成します。

BOOL CreateCompatibleDC(
   CDC* pDC 
);

パラメータ

pDC
デバイスコンテキストへのポインタ。pDC が NULL のときは、システムディスプレイと互換性のあるメモリデバイスコンテキストが作成されます。

戻り値

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

解説

メモリデバイスコンテキストは、ディスプレイ表面を表すメモリのブロックです。メモリデバイスコンテキストは、デバイスの実際のディスプレイ表面にコピーするためのイメージをメモリ内に準備するために使います。

メモリデバイスコンテキストが作成されると、GDI はそのメモリデバイスコンテキストに対して 1 × 1 のモノクロのストックビットマップを自動的に選択します。ビットマップが作成され、コンテキストに対して選択されているときだけ、メモリデバイスコンテキストに、GDI 出力関数を使うことができます。

この関数は、ラスタオペレーションをサポートするデバイスと互換性のあるデバイスコンテキストを作成するときにだけ使われます。デバイスコンテキスト間のビットのブロック転送に関する情報は、CDC::BitBlt メンバ関数を参照してください。デバイスコンテキストがラスタオペレーションをサポートするかどうかを調べるには、CDC::GetDeviceCaps メンバ関数の RC_BITBLT ラスタ機能を参照してください。

使用例

// This handler loads a bitmap from system resources,
// centers it in the view, and uses BitBlt() to paint the bitmap
// bits.
void CDCView::DrawBitmap(CDC* pDC)
{
   // load IDB_BITMAP1 from our resources
   CBitmap bmp;
   if (bmp.LoadBitmap(IDB_BITMAP1))
   {
      // Get the size of the bitmap
      BITMAP bmpInfo;
      bmp.GetBitmap(&bmpInfo);

      // Create an in-memory DC compatible with the
      // display DC we're using to paint
      CDC dcMemory;
      dcMemory.CreateCompatibleDC(pDC);

      // Select the bitmap into the in-memory DC
      CBitmap* pOldBitmap = dcMemory.SelectObject(&bmp);

      // Find a centerpoint for the bitmap in the client area
      CRect rect;
      GetClientRect(&rect);
      int nX = rect.left + (rect.Width() - bmpInfo.bmWidth) / 2;
      int nY = rect.top + (rect.Height() - bmpInfo.bmHeight) / 2;

      // Copy the bits from the in-memory DC into the on-
      // screen DC to actually do the painting. Use the centerpoint
      // we computed for the target offset.
      pDC->BitBlt(nX, nY, bmpInfo.bmWidth, bmpInfo.bmHeight, &dcMemory, 
         0, 0, SRCCOPY);

      dcMemory.SelectObject(pOldBitmap);
   }
   else
   {
      TRACE0("ERROR: Where's IDB_BITMAP1?\n");
   }
}