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

Artigo
08/24/2023

O método Graphics::FromImage cria um objeto Graphics associado a um objeto Image especificado.

Sintaxe

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

Parâmetros

[in] image

Tipo: Imagem*

Ponteiro para um objeto Image que será associado ao novo objeto Graphics .

Valor retornado

Tipo: Gráficos*

Esse método retorna um ponteiro para o novo objeto Graphics .

Comentários

Esse método falhará se o objeto Image for baseado em um metarquivo que foi aberto para leitura. Os construtores Image::Image(filename, useEmbeddedColorManagement) e Metafile::Metafile(filename) abrem um metafile para leitura. Para abrir um meta-arquivo para gravação, use um construtor de Metafile que recebe um identificador de contexto do dispositivo.

Esse método também falhará se a imagem tiver um dos seguintes formatos de pixel:

PixelFormatUndefined
PixelFormatDontCare
PixelFormat1bppIndexed
PixelFormat4bppIndexed
PixelFormat8bppIndexed
PixelFormat16bppGrayScale
PixelFormat16bppARGB1555

Exemplos

O exemplo a seguir chama o método Graphics::FromImage para criar um objeto Graphics associado a um objeto Image . A chamada para Graphics::FillEllipse não pinta no dispositivo de exibição; em vez disso, ele altera o bitmap do objeto Image . A chamada para Graphics::D rawImage exibe o bitmap alterado.

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 com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll