Clase CImage

CImage proporciona compatibilidad mejorada del mapa de bits, incluida la capacidad de cargar y guardar imágenes en JPEG, GIF, BMP, y los formatos de (PNG) de gráficos de red de Portable.

Importante
Esta clase y sus miembros no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.

class CImage

Members

Constructores públicos

Métodos públicos

Operadores públicos

Comentarios

CImage toma los mapas de bits que son secciones de (DIB) de mapa de bits independiente del dispositivo o no; sin embargo, puede utilizar cree o CImage::Load con sólo las secciones del archivo DIB.Puede adjuntar un mapa de bits de la sección de no DIB a un objeto de CImage mediante Asociar, pero después no puede utilizar los siguientes métodos de CImage , que solo admiten mapas de bits de la sección del archivo DIB:

• GetBits

• GetColorTable

• GetMaxColorTableEntries

• GetPitch

• GetPixelAddress

• IsIndexed

• SetColorTable

Para determinar si un mapa de bits asociado es una sección del archivo DIB, llame a IsDibSection.

[!NOTA]

Note en Visual Studio .NET 2003, esta clase mantiene un recuento del número de objetos de CImage creado.Siempre que el recuento vaya a 0, la función GdiplusShutdown automáticamente se denomina para liberar los recursos utilizados por GDI+.Esto asegura que cualquier objeto de CImage creado directa o indirectamente por los archivos DLL se destruirá siempre correctamente y que GdiplusShutdown no se llama de DllMain.

[!NOTA]

Mediante CImage global los objetos de DLL no se recomienda.Si necesita utilizar un objeto de CImage en un archivo DLL, la llamada CImage:: ReleaseGDIPlus explícitamente para liberar los recursos utilizados por GDI+.

CImage no se puede seleccionar en el nuevo CDC.CImage crea su propio HDC para la imagen.Dado que HBITMAP puede seleccionarse solo en un HDC al mismo tiempo, HBITMAP asociado a CImage no puede seleccionarse en otro HDC.Si necesita CDC, recupere HDC de CImage y darle a CDC::FromHandle.

Ejemplo

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

Cuando se utiliza CImage en un proyecto MFC, la nota que las funciones miembro del proyecto espera recibir un puntero a un objeto de CBitmap .Si desea utilizar CImage con esta función, como CMenu::AppendMenu, el uso CBitmap::FromHandle, para pasar el CImageHBITMAP, y utilizar **CBitmap***devuelto.

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);
}

Con CImage, tiene acceso a los bits reales de una sección DIB.Puede utilizar un objeto de CImage dondequiera que utilizó anteriormente HBITMAP de Win32 o la sección DIB.

[!NOTA]

Los siguientes métodos de CImage tienen limitaciones en el uso:

Vea CImage Limitaciones con sistemas operativos anteriores para obtener información detallada sobre las limitaciones de estos métodos.

Puede utilizar CImage MFC o ATL.

[!NOTA]

Cuando se crea un proyecto mediante CImage, debe definir CString antes de que incluye atlimage.h.Si el proyecto usa ATL sin MFC, incluyen atlstr.h antes de que incluye atlimage.h.Si el proyecto utiliza MFC (o si es un proyecto ATL con compatibilidad con MFC), incluya afxstr.h antes de que incluye atlimage.h.

Igualmente, debe incluir atlimage.h antes de que incluye atlimpl.cpp.Para realizarlo fácilmente, incluya atlimage.h en su stdafx.h.

Requisitos

Header: atlimage.h

Vea también

Referencia

Device-Independent Bitmaps

CreateDIBSection

Conceptos

Ejemplo MMXSwarm

Ejemplo SimpleImage

Otros recursos

Componentes de escritorio COM ATL