Método Graphics::D rawImage(Image*,constRect&) (gdiplusgraphics.h)
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.
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 |
Consulte también
Dibujo, posicionamiento y clonación de imágenes