Klasa CImage

CImagezapewnia obsługę rozszerzonych bitmapy, włączając możliwość załadowania i zapisywanie obrazów w formatach JPEG, GIF, BMP i Portable Network Graphics (PNG).

Ważne
W aplikacjach, które są wykonywane w Windows Runtime nie można użyć tej klasy i jej członków.

class CImage

Członkowie

Publiczne konstruktory

Metody publiczne

Podmioty publiczne

Uwagi

CImageTrwa bitmap, które są albo sekcje mapy bitowej niezależnej od urządzenia (DIB) lub nie; można jednak użyć Tworzenie lub CImage::Load z tylko sekcje DIB.Bitmapę sekcji DIB nie można dołączyć CImage obiektu za pomocą Dołącz, ale następnie nie można używać następujących CImage metody, które obsługują tylko DIB sekcji bitmapy:

• GetBits

• GetColorTable

• GetMaxColorTableEntries

• GetPitch

• GetPixelAddress

• IsIndexed

• SetColorTable

Aby określić, czy dołączone mapy bitowej jest sekcja DIB, call IsDibSection.

[!UWAGA]

Uwaga W Visual Studio .net 2003, ta klasa przechowuje licznika liczby CImage obiekty utworzone.Gdy licznik przechodzi do 0, funkcja GdiplusShutdown nazywa się automatycznie zwolnić zasoby używane przez GDI +.Gwarantuje to, że dowolny CImage obiektów utworzonych bezpośrednio lub pośrednio przez dll zawsze są właściwie zniszczone oraz że GdiplusShutdown nie jest wywoływana z DllMain.

[!UWAGA]

Za pomocą globalnej CImage obiektów w bibliotece DLL nie jest zalecane.Jeśli trzeba użyć globalnym CImage obiektu w bibliotece DLL wywołania CImage::ReleaseGDIPlus jawnie zwolnić zasoby używane przez GDI +.

CImagenie można wybrać do nowego CDC.CImagetworzy własną HDC obrazu.Ponieważ HBITMAP można wybrać tylko do jednej HDC w czasie, HBITMAP związane z CImage nie można wybrać do innego HDC.Jeśli potrzebujesz CDC, pobrać HDC z CImage i nadać jej do CDC::FromHandle.

Przykład

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

Kiedy używać CImage w projekcie MFC Uwaga funkcji elementów członkowskich, które w projekcie oczekiwać wskaźnik do CBitmap obiektu.Jeśli chcesz użyć CImage z funkcją, jak CMenu::AppendMenu, użyj CBitmap::FromHandle, przekazać je na CImageHBITMAPi zwrócony 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);
}

Poprzez CImage, masz dostęp do bitów sekcji DIB.Można użyć CImage obiekt dowolnym poprzednio używane sekcji Win32 HBITMAP lub DIB.

[!UWAGA]

Następujące CImage metody mają ograniczenia ich stosowania:

Zobacz CImage ograniczenia z wcześniejszych systemów operacyjnych Aby uzyskać więcej informacji na temat tych metod.

Można użyć CImage z MFC lub ATL.

[!UWAGA]

Podczas tworzenia projektu przy użyciu CImage, należy zdefiniować CString przed dołączeniem atlimage.h.Jeśli Projekt ATL bez MFC, obejmują atlstr.h przed dołączeniem atlimage.h.Jeśli projekt używa MFC (lub jeśli jest to Projekt ATL z obsługą MFC), afxstr.h przed dołączeniem atlimage.h.

Podobnie, musi zawierać atlimage.h przed dołączeniem atlimpl.cpp.Aby to łatwo osiągnąć, atlimage.h w sieci stdafx.h.

Wymagania

Nagłówek: atlimage.h

Zobacz też

Informacje

Device-Independent Bitmaps

CreateDIBSection

Koncepcje

Próbki MMXSwarm

SimpleImage próbki.

Inne zasoby

Składniki COM pulpitu ATL