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

Artículo
08/24/2023

El método Graphics::D rawImage dibuja una imagen.

Sintaxis

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
);

Parámetros

[in] image

Tipo: Imagen*

Puntero a un objeto Image que especifica la imagen de origen.

[in, ref] destRect

Tipo: const RectF

Referencia a un rectángulo que enlaza el área de dibujo de la imagen.

[in] srcx

Tipo: REAL

Número real que especifica la coordenada x de la esquina superior izquierda de la parte de la imagen de origen que se va a dibujar.

[in] srcy

Tipo: REAL

Número real que especifica la coordenada y de la esquina superior izquierda de la parte de la imagen de origen que se va a dibujar.

[in] srcwidth

Tipo: REAL

Número real que especifica el ancho de la parte de la imagen de origen que se va a dibujar.

[in] srcheight

Tipo: REAL

Número real que especifica el alto de la parte de la imagen de origen que se va a dibujar.

[in] srcUnit

Tipo: Unidad

Elemento de la enumeración Unit que especifica la unidad de medida de la imagen. El valor predeterminado es UnitPixel.

[in] imageAttributes

Tipo: ImageAttributes*

Puntero a un objeto ImageAttributes que especifica los atributos de color y tamaño de la imagen que se van a dibujar. El valor predeterminado es NULL.

[in] callback

Tipo: DrawImageAbort

Método de devolución de llamada usado para cancelar el dibujo en curso. El valor predeterminado es NULL.

[in] callbackData

Tipo: VOID*

Puntero a datos adicionales utilizados por el método especificado por el parámetro callback . El valor predeterminado es NULL.

Valor devuelto

Tipo: Estado

Si el método se realiza 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 parte de la imagen de origen que se va a dibujar se escala para ajustarse al rectángulo.

Ejemplos

En el ejemplo siguiente se dibuja la imagen de origen original y, a continuación, se dibuja una parte de la imagen en un rectángulo especificado.

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);

}

En la ilustración siguiente se muestra la salida del código anterior.

Ilustración en la que se muestran dos gráficos: un patrón de tablero de verificación multicolor y, a continuación, una ampliación de dos tonadas a partir de ese patrón

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