Graphics ::D rawImage(Image,constRectF&,REAL,REAL,REAL,Unit,constImageAttributes,DrawImageAbort,VOID*) méthode (gdiplusgraphics.h)

Article
08/24/2023

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

Syntaxe

Status DrawImage(
  [in]      Image                 *image,
  [in, ref] const RectF &         destRect,
  [in]      REAL                  srcx,
  [in]      REAL                  srcy,
  [in]      REAL                  srcwidth,
  [in]      REAL                  srcheight,
  [in]      Unit                  srcUnit,
  [in]      const ImageAttributes *imageAttributes,
  [in]      DrawImageAbort        callback,
  [in]      VOID                  *callbackData
);

Paramètres

[in] image

Type : Image*

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

[in, ref] destRect

Type : const RectF

Référence à un rectangle qui lie la zone de dessin de l’image.

[in] srcx

Type : REAL

Nombre réel qui spécifie la coordonnée x du coin supérieur gauche de la partie de l’image source à dessiner.

[in] srcy

Type : REAL

Nombre réel qui spécifie la coordonnée y du coin supérieur gauche de la partie de l’image source à dessiner.

[in] srcwidth

Type : REAL

Nombre réel qui spécifie la largeur de la partie de l’image source à dessiner.

[in] srcheight

Type : REAL

Nombre réel qui spécifie la hauteur de la partie de l’image source à dessiner.

[in] srcUnit

Type : Unité

Élément de l’énumération Unit qui spécifie l’unité de mesure de l’image. La valeur par défaut est UnitPixel.

[in] imageAttributes

Type : ImageAttributes*

Pointeur vers un objet ImageAttributes qui spécifie les attributs de couleur et de taille de l’image à dessiner. La valeur par défaut est NULL.

[in] callback

Type : DrawImageAbort

Méthode de rappel utilisée pour annuler le dessin en cours. La valeur par défaut est NULL.

[in] callbackData

Type : VOID*

Pointeur vers des données supplémentaires utilisées par la méthode spécifiée par le paramètre de rappel . La valeur par défaut est NULL.

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

La partie de l’image source à dessiner est mise à l’échelle pour s’adapter au rectangle.

Exemples

L’exemple suivant dessine l’image source d’origine, puis dessine une partie de l’image dans un rectangle spécifié.

VOID Example_DrawImage6(HDC hdc)

{

   Graphics graphics(hdc);



   // Create an Image object.

   Image image(L"pattern.png");



   // Draw the original source image.

   graphics.DrawImage(&image, 10, 10);



   // Define the portion of the image to draw.

   REAL srcX = 70.0f;

   REAL srcY = 20.0f;

   REAL srcWidth = 100.0f;

   REAL srcHeight = 100.0f;



   // Create a RectF object that specifies the destination of the image.

   RectF destRect(200.0f, 10.0f, <REAL>image.GetWidth(), <REAL>image.GetHeight());

   

   // Create an ImageAttributes object that specifies a recoloring from red to blue.

   ImageAttributes remapAttributes;

   ColorMap redToBlue;

   redToBlue.oldColor = Color(255, 255, 0, 0);

   redToBlue.newColor = Color(255, 0, 0, 255);

   remapAttributes.SetRemapTable(1, &redToBlue);



   // Draw the resized image.

   graphics.DrawImage(

   &image,

   destRect,

   srcX,

   srcY,

   srcWidth,

   srcHeight,

   UnitPixel,

   &remapAttributes,

   NULL,

   NULL);

}

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

Illustration montrant deux graphiques : un motif de damier multicolore, puis un agrandissement à deux tonalités à partir de ce modèle

Configuration requise


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