Método Graphics::D rawImage(Image*,constRectF&) (gdiplusgraphics.h)

Artigo
02/28/2024

O método Graphics::D rawImage desenha uma imagem.

Sintaxe

Status DrawImage(
  [in]      Image         *image,
  [in, ref] const RectF & rect
);

Parâmetros

[in] image

Tipo: Imagem*

Ponteiro para um objeto Image que especifica a imagem de origem.

[in, ref] rect

Tipo: const RectF

Referência a um retângulo que vincula a área de desenho para a imagem.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

A imagem é dimensionada para se ajustar ao retângulo.

Exemplos

O exemplo a seguir desenha a imagem de origem, o retângulo que vincula a imagem redimensionada e desenha a imagem redimensionada para caber no retângulo.

VOID Example_DrawImage10(HDC hdc)

{
   Graphics graphics(hdc);

   // Create an Image object.
   Image image(L"climber.jpg");

   // Create a Pen object.
   Pen pen (Color(255, 255, 0, 0), 2);

   // Draw the original source image.
   graphics.DrawImage(&image, 10, 10);

   // Create a RectF object that specifies the destination of the image.
   RectF destRect(200, 50, 150, 75);

   // Draw the rectangle that bounds the image.
   graphics.DrawRectangle(&pen, destRect);

   // Draw the image.
   graphics.DrawImage(&image, destRect);
}

A ilustração a seguir mostra a saída do código anterior.

Ilustração mostrando duas versões da mesma imagem; o segundo é ligeiramente mais estreito do que o primeiro, muito menor, e descrito em vermelho

Requisitos

Requisito	Valor
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