Metodo Graphics::D rawImage(Image*,constRectF&) (gdiplusgraphics.h)

Articolo
03/05/2024

Il metodo Graphics::D rawImage disegna un'immagine.

Sintassi

Status DrawImage(
  [in]      Image         *image,
  [in, ref] const RectF & rect
);

Parametri

[in] image

Tipo: Immagine*

Puntatore a un oggetto Image che specifica l'immagine di origine.

[in, ref] rect

Tipo: const RectF

Riferimento a un rettangolo che delimita l'area di disegno per l'immagine.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

L'immagine viene adattata al rettangolo.

Esempio

L'esempio seguente disegna l'immagine di origine, il rettangolo che delimita l'immagine ridimensionata e quindi disegna l'immagine ridimensionata per adattarla al rettangolo.

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

La figura seguente mostra l'output del codice precedente.

Illustrazione che mostra due versioni della stessa immagine; il secondo è leggermente più stretto del primo, molto più breve, e delineato in rosso

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll