Graphics.FromImage(Image) 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
public:
static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);C#
public static System.Drawing.Graphics FromImage(System.Drawing.Image image);static member FromImage : System.Drawing.Image -> System.Drawing.GraphicsPublic Shared Function FromImage (image As Image) As Graphics
image
null。
image 具有索引像素格式或其格式未定義。
下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程式代碼會執行下列動作：
public:
void FromImageImage( PaintEventArgs^ e )
{
// Create image.
Image^ imageFile = Image::FromFile( "SampImag.jpg" );
// Create graphics object for alteration.
Graphics^ newGraphics = Graphics::FromImage( imageFile );
// Alter image.
newGraphics->FillRectangle( gcnew SolidBrush( Color::Black ), 100, 50, 100, 100 );
// Draw image to screen.
e->Graphics->DrawImage( imageFile, PointF(0.0F,0.0F) );
// Dispose of graphics object.
delete newGraphics;
}
C#
private void FromImageImage(PaintEventArgs e)
{
// Create image.
Image imageFile = Image.FromFile("SampImag.jpg");
// Create graphics object for alteration.
Graphics newGraphics = Graphics.FromImage(imageFile);
// Alter image.
newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100);
// Draw image to screen.
e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F));
// Dispose of graphics object.
newGraphics.Dispose();
}
Private Sub FromImageImage2(ByVal e As PaintEventArgs)
' Create image.
Dim imageFile As Image = Image.FromFile("SampImag.jpg")
' Create graphics object for alteration.
Dim newGraphics As Graphics = Graphics.FromImage(imageFile)
' Alter image.
newGraphics.FillRectangle(New SolidBrush(Color.Black), _
100, 50, 100, 100)
' Draw image to screen.
e.Graphics.DrawImage(imageFile, New PointF(0.0F, 0.0F))
' Dispose of graphics object.
newGraphics.Dispose()
End Sub
如果影像具有已編製索引的圖元格式，這個方法會擲回含有訊息的例外狀況：「無法從具有索引圖元格式的影像建立 Graphics 物件」。索引像素格式會顯示在下列清單中。
您可以使用 Save(String, ImageFormat) 方法來將索引影像儲存為另一種格式，然後擷取新影像的 Graphics 物件。
如果影像具有下列任何像素格式，這個方法也會擲回例外狀況。
您應該一律呼叫 Dispose 方法來釋放 FromImage 方法所建立的 Graphics 和相關資源。
| 產品 | 版本 |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
- 如何：在運行時間建立位圖
- 使用影像、位圖、圖示和元檔
- 如何：建立繪圖 的圖形物件
