Graphics：：FromImage 方法 (gdiplusgraphics.h)

發行項
03/14/2023

Graphics：：FromImage方法會建立與指定Image物件相關聯的Graphics物件。

語法

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

參數

[in] image

類型：影像*

與新Graphics物件相關聯的Image物件指標。

傳回值

類型：圖形*

這個方法會傳回新 Graphics 物件的指標。

備註

如果 Image 物件是以開啟以供讀取的中繼檔為基礎，這個方法就會失敗。 Image：：Image (filename，useEmbeddedColorManagement) 和Metafile：：Metafile (filename) 建構函式開啟中繼檔以供讀取。若要開啟要錄製的中繼檔，請使用接收裝置內容控制碼的 Metafile 建構函式。

如果影像有下列其中一個像素格式，此方法也會失敗：

PixelFormatUndefined
PixelFormatDontCare
PixelFormat1bppIndexed
PixelFormat4bppIndexed
PixelFormat8bppIndexed
PixelFormat16bppGrayScale
PixelFormat16bppARGB1555

範例

下列範例會呼叫Graphics：：FromImage方法，以建立與Image物件相關聯的Graphics物件。對 Graphics：：FillEllipse 的呼叫不會繪製在顯示裝置上;相反地，它會改變 Image 物件的點陣圖。對 Graphics：:D rawImage的呼叫會顯示已改變的點陣圖。

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

需求


最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusgraphics.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll