Graphics ::D rawImage(Image,constPoint,INT) , méthode (gdiplusgraphics.h)

Article
02/29/2024

La méthode Graphics ::D rawImage dessine une image.

Syntaxe

Status DrawImage(
  [in] Image       *image,
  [in] const Point *destPoints,
  [in] INT         count
);

Paramètres

[in] image

Type : Image*

Pointeur vers un objet Image qui spécifie l’image source.

[in] destPoints

Type : const Point*

Pointeur vers un tableau d’objets Point qui spécifient la zone, dans un paralléliogramme, dans laquelle dessiner l’image.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments dans le tableau destPoints .

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 InvalidParameter.

Remarques

La valeur du paramètre count doit être égale à 3 pour spécifier les trois coins du paralléliogramme. Le quatrième coin du paralléliogramme est calculé à l’aide des vecteurs de la première et de la deuxième coordonnées et des première et troisième coordonnées. L’image est mise à l’échelle pour s’adapter au paralléliogramme.

Exemples

L’exemple suivant dessine une image.

VOID Example_DrawImage(HDC hdc)

{

   Graphics graphics(hdc);

   // Create an Image object.
   Image image(L"climber.jpg");

   // Create an array of Point objects that specify the destination of the image.
   Point destPoints[3] = {
   Point(30, 30),
   Point(250, 50),
   Point(175, 120)};

   Point* pdestPoints = destPoints;

   // Draw the image.
   graphics.DrawImage(&image, pdestPoints, 3);
}

L’illustration suivante montre la sortie du code précédent.

Illustration montrant une image précédemment rectangulaire qui est maintenant cisurée en paralléliogramme

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