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

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

Sintaxe

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

Parâmetros

[in] image

Tipo: Imagem*

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

[in, ref] rect

Tipo: const Rect

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 ajustar o retângulo.

VOID Example_DrawImage9(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 Rect object that specifies the destination of the image.
   Rect 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.

Requisitos

Confira também

Desenhar, posicionar e clonar imagens

Elementos gráficos

Imagem

Carregando e exibindo bitmaps

Rect