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

Artículo
03/16/2023

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

Sintaxis

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

Parámetros

[in] image

Tipo: Imagen*

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

[in, ref] rect

Tipo: const Rect

Referencia a un rectángulo que enlaza el área de dibujo de la imagen.

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

La imagen se reduce de escala para que encaje en el rectángulo.

Ejemplos

En el ejemplo siguiente se dibuja la imagen de origen, el rectángulo que enlaza la imagen cuyo tamaño ha cambiado y, a continuación, dibuja la imagen cuyo tamaño se ajusta al rectá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);
}

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

Ilustración en la que se muestran dos versiones de la misma imagen; el segundo es ligeramente más estrecho que el primero, mucho más corto, y descrito en rojo

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