CImage クラス

CImage は、BMP、GIF、JPEG、PNG (Portable Network Graphics (PNG) の形式のイメージの読み込みや保存などが強化されたビットマップ サポートを提供します。

重要
このクラスおよびメンバーは、Windows のランタイムで実行するアプリケーションで使用することはできません。

class CImage

メンバー

パブリック コンストラクター

パブリック メソッド

パブリック演算子

解説

CImage は、デバイスに依存しないビットマップの (DIB) のセクションまたは、ではないビットマップを使用します; ただし、DIB セクションだけで [作成] か CImage::Load を使用できます。[アタッチ]を使用して CImage のオブジェクトに、DIB セクションのビットマップをアタッチできますが、その場合は DIB セクションのビットマップだけをサポートする CImage の次のメソッドを使用できません:

• GetBits

• GetColorTable

• GetMaxColorTableEntries

• GetPitch

• GetPixelAddress

• IsIndexed

• SetColorTable

アタッチされているビットマップの DIB セクションであるかどうかを確認するには、IsDibSection**.**を呼び出します。

[!メモ]

Visual Studio .NET 2003 のNote は、このクラス CImage のオブジェクトの数を作成しておきます。カウントが 0 に移動するたびに GDI+ によって使用されるリソースを解放するための関数 GdiplusShutdown は自動的に呼び出されます。これは、DLL によって直接または間接的に作成される CImage のオブジェクトは、常に適切に破棄されていること、および GdiplusShutdown が DllMainから呼び出されていないことを確認します。

[!メモ]

DLL の CImage のグローバル オブジェクトはお勧めしません。DLL で CImage のグローバル オブジェクトを使用する必要がある場合、明示的に GDI+ が使用していたリソースを解放する呼び出し CImage::ReleaseGDIPlus。

CImage は、新しい CDCに選択することはできません。CImage、イメージの独自の HDC を作成します。HBITMAP が 1 HDC に一度に選択できないため CImage に関連付けられている HBITMAP は別の HDCに選択することはできません。CDCが必要な場合は、HDC を CImage から取得し、CDC::FromHandleにそれを付けます。

使用例

// Get a CDC for the image
CDC* pDC = CDC::FromHandle(m_myImage.GetDC());

// Use pDC here
pDC->Rectangle(0, 40, 100, 50);

m_myImage.ReleaseDC();

MFC プロジェクトに CImage を使用すると、プロジェクトのメンバー関数が CBitmap のオブジェクトへのポインターを要求されます。このような関数に CImage を、CMenu::AppendMenu、使用 CBitmap::FromHandleを使用して、の CImageHBITMAPを渡し、返された **CBitmap***を使用する場合は。

void CMyDlg::OnRButtonDown(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);

   CBitmap* pBitmap = CBitmap::FromHandle(m_myImage);
   m_pmenuPop->AppendMenu(0, ID_BMPCOMMAND, pBitmap);
   ClientToScreen(&point);
   m_pmenuPop->TrackPopupMenu(TPM_RIGHTBUTTON | TPM_LEFTALIGN, point.x, 
      point.y, this);
}

CImageによって、DIB セクションの実際のビットにアクセスできます。CImage のオブジェクトを使用して、どこでも、以前に Win32 HBITMAP かの DIB セクションを使用します。

[!メモ]

CImage の次のメソッドの使用に関する制限事項があります:

これらのメソッドの制限に関する詳細については 以前のオペレーティング システムに CImage の制限 を参照してください。

MFC または ATL の CImage を使用できます。

[!メモ]

CImageを使用してプロジェクトを作成すると、atlimage.hをインクルードする前に CString を定義する必要があります。プロジェクトが MFC なしでは、ATL を使用している場合は、atlimage.hをインクルードする前に atlstr.h を含めます。これは MFC サポートを使用して ATL プロジェクトを使用している場合は、プロジェクトが MFC (または)、atlimage.hをインクルードする前に afxstr.h を含めます。

同様に atlimpl.cppをインクルードする前に、atlimage.h を含める必要があります。これを簡単に実現するには、の stdafx.hに atlimage.h を含めます。

必要条件

Header: atlimage.h

参照

関連項目

Device-Independent Bitmaps

CreateDIBSection

概念

MMXSwarm サンプル

SimpleImage サンプル

その他の技術情報

ATL COM デスクトップ コンポーネント