Método Graphics::D rawImage(Image*,constPointF*,INT) (gdiplusgraphics.h)

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

Sintaxe

Status DrawImage(
  [in] Image        *image,
  [in] const PointF *destPoints,
  [in] INT          count
);

Parâmetros

[in] image

Tipo: Imagem*

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

[in] destPoints

Tipo: const PointF*

Ponteiro para uma matriz de objetos PointF que especificam a área, em um paralelograma, na qual desenhar a imagem.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos na matriz destPoints .

Valor retornado

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

O valor do parâmetro count deve ser igual a 3 para especificar as coordenadas do canto superior esquerdo, canto superior direito e canto inferior esquerdo do parallelogram. A coordenada do canto inferior direito é calculada usando as três coordenadas fornecidas, a largura e a altura da imagem. A imagem é dimensionada para se ajustar ao paralelismo.

Exemplos

O exemplo a seguir desenha uma imagem.

VOID Example_DrawImage3(HDC hdc)

{
   Graphics graphics(hdc);

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

   // Create an array of PointF objects that specify the destination of the image.
   PointF destPoints[3] = {
   PointF(30.0f, 30.0f),
   PointF(250.0f, 50.0f),
   PointF(175.0f, 120.0f)};

   PointF* pdestPoints = destPoints;

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

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

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

Confira também

Desenhar, posicionar e clonar imagens

Elementos gráficos

Imagem

Carregando e exibindo bitmaps

Ponto