Graphics::D rawImage(Image,constPointF,INT) (gdiplusgraphics.h)

Artículo
08/24/2023

El método Graphics::D rawImage dibuja una imagen.

Sintaxis

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

Parámetros

[in] image

Tipo: Imagen*

Puntero a un objeto Image que especifica la imagen de origen.

[in] destPoints

Tipo: const PointF*

Puntero a una matriz de objetos PointF que especifican el área, en un paralegrama, en el que se va a dibujar la imagen.

[in] count

Tipo: INT

Entero que especifica el número de elementos de la matriz destPoints .

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

El valor del parámetro count debe ser igual a 3 para especificar las coordenadas de la esquina superior izquierda, la esquina superior derecha y la esquina inferior izquierda del paralelismo. La coordenada de la esquina inferior derecha se calcula utilizando las tres coordenadas dadas, el ancho y el alto de la imagen. La imagen se escala para ajustarse al paralelismo.

Ejemplos

En el ejemplo siguiente se dibuja una imagen.

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);
}

En la ilustración siguiente se muestra la salida del código anterior.

Ilustración en la que se muestra una imagen previamente rectangular que se ha desarizado en un paralelgrama

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll