Compartir a través de


Graphics::D rawImage(Image*,constRectF&) (gdiplusgraphics.h)

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

Sintaxis

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

Parámetros

[in] image

Tipo: Imagen*

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

[in, ref] rect

Tipo: const RectF

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_DrawImage10(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 RectF object that specifies the destination of the image.
   RectF 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

Requisito Value
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

Consulte también

Dibujo, posicionamiento y clonación de imágenes

Elementos gráficos

Imagen

Cargar y mostrar mapas de bits

RectF