Método Graphics::FromImage (gdiplusgraphics.h)

Artículo
03/14/2023

El método Graphics::FromImage crea un objeto Graphics asociado a un objeto Image especificado.

Sintaxis

Graphics * FromImage(
  [in] Image *image
);

Parámetros

[in] image

Tipo: Imagen*

Puntero a un objeto Image que se asociará al nuevo objeto Graphics .

Valor devuelto

Tipo: Gráficos*

Este método devuelve un puntero al nuevo objeto Graphics .

Comentarios

Este método produce un error si el objeto Image se basa en un metarchivo que se abrió para su lectura. Los constructores Image::Image(filename, useEmbeddedColorManagement) y Metafile::Metafile(filename) abren un metarchivo para su lectura. Para abrir un metarchivo para la grabación, use un constructor de metarchivo que reciba un identificador de contexto del dispositivo.

Este método también produce un error si la imagen tiene uno de los formatos de píxeles siguientes:

PixelFormatUndefined
PixelFormatDontCare
PixelFormat1bppIndexed
PixelFormat4bppIndexed
PixelFormat8bppIndexed
PixelFormat16bppGrayScale
PixelFormat16bppARGB1555

Ejemplos

En el ejemplo siguiente se llama al método Graphics::FromImage para crear un objeto Graphics asociado a un objeto Image . La llamada a Graphics::FillEllipse no pinta en el dispositivo de pantalla; en su lugar, modifica el mapa de bits del objeto Image . La llamada a Graphics::D rawImage muestra el mapa de bits modificado.

VOID Example_FromImage(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an Image object from a PNG file.
   Image image(L"Mosaic.png");

   // Create a Graphics object that is associated with the image.
   Graphics* imageGraphics = Graphics::FromImage(&image);
   
   // Alter the image.
   SolidBrush brush(Color(255, 0, 0, 255));
   imageGraphics->FillEllipse(&brush, 10, 40, 100, 50);

   // Draw the altered image.
   graphics.DrawImage(&image, 30, 20);
   
   delete imageGraphics;
}

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll