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

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

Sintaxe

Status DrawImage(
  [in] Image       *image,
  [in] const Point *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 Point*

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

[in] count

Tipo: INT

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

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á InvalidParameter.

Comentários

O valor do parâmetro count deve ser igual a 3 para especificar os três cantos do parallelogram. O quarto canto do parallelogram é calculado usando os vetores da primeira e segunda coordenadas e a primeira e terceira coordenadas. A imagem é dimensionada para se ajustar ao parallelogram.

Exemplos

O exemplo a seguir desenha uma imagem.

VOID Example_DrawImage(HDC hdc)

{

   Graphics graphics(hdc);

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

   // Create an array of Point objects that specify the destination of the image.
   Point destPoints[3] = {
   Point(30, 30),
   Point(250, 50),
   Point(175, 120)};

   Point* pdestPoints = destPoints;

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

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

Ilustração mostrando uma imagem retangular anteriormente que agora está desarmada em um parallelogram

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

Confira também

Desenhar, posicionar e clonar imagens

Elementos gráficos

Imagem

Carregando e exibindo bitmaps

Ponto