Graphics::FromImage-Methode (gdiplusgraphics.h)

2023-08-24

Die Graphics::FromImage-Methode erstellt ein Graphics-Objekt , das einem angegebenen Image-Objekt zugeordnet ist.

Syntax

Graphics * FromImage(
  [in] Image *image
);

Parameter

[in] image

Typ: Bild*

Zeiger auf ein Image-Objekt , das dem neuen Graphics-Objekt zugeordnet wird.

Rückgabewert

Typ: Grafiken*

Diese Methode gibt einen Zeiger auf das neue Graphics-Objekt zurück.

Hinweise

Diese Methode schlägt fehl, wenn das Image-Objekt auf einer Metadatei basiert, die zum Lesen geöffnet wurde. Die Konstruktoren Image::Image(filename, useEmbeddedColorManagement) und Metafile::Metafile(filename) öffnen eine Metadatei zum Lesen. Verwenden Sie zum Öffnen einer Metadatei für die Aufzeichnung einen Metadateikonstruktor , der ein Gerätekontexthandle empfängt.

Diese Methode schlägt auch fehl, wenn das Bild eines der folgenden Pixelformate aufweist:

PixelFormatUndefined
PixelFormatDontCare
PixelFormat1bppIndexed
PixelFormat4bppIndexed
PixelFormat8bppIndexed
PixelFormat16bppGrayScale
PixelFormat16bppARGB1555

Beispiele

Im folgenden Beispiel wird die Graphics::FromImage-Methode aufgerufen, um ein Graphics-Objekt zu erstellen, das einem Image-Objekt zugeordnet ist. Der Aufruf von Graphics::FillEllipse wird nicht auf dem Anzeigegerät gezeichnet. stattdessen wird die Bitmap des Image-Objekts geändert. Der Aufruf von Graphics::D rawImage zeigt die geänderte Bitmap an.

VOID Example_FromImage(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an Image object from a PNG file.
   Image image(L"Mosaic.png");

   // Create a Graphics object that is associated with the image.
   Graphics* imageGraphics = Graphics::FromImage(&image);
   
   // Alter the image.
   SolidBrush brush(Color(255, 0, 0, 255));
   imageGraphics->FillEllipse(&brush, 10, 40, 100, 50);

   // Draw the altered image.
   graphics.DrawImage(&image, 30, 20);
   
   delete imageGraphics;
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll