Graphics ::D rawImage(Image*,constRectF&) (gdiplusgraphics.h)
La méthode Graphics ::D rawImage dessine une image.
Syntaxe
Status DrawImage(
[in] Image *image,
[in, ref] const RectF & rect
);
Paramètres
[in] image
Type : Image*
Pointeur vers un objet Image qui spécifie l’image source.
[in, ref] rect
Type : const RectF
Référence à un rectangle qui lie la zone de dessin de l’image.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Remarques
L'image est ajustée de manière à tenir à l'intérieur du rectangle.
Exemples
L’exemple suivant dessine l’image source, le rectangle qui lie l’image redimensionnée, puis dessine l’image redimensionnée pour l’adapter au rectangle.
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);
}
L’illustration suivante montre la sortie du code précédent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusgraphics.h (include Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |
Voir aussi
Dessin, positionnement et clonage d’images