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

Graphismes

Image

Chargement et affichage de bitmaps

RectF