Graphics.FromImage(Image) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
public:
static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);
public static System.Drawing.Graphics FromImage(System.Drawing.Image image);
static member FromImage : System.Drawing.Image -> System.Drawing.Graphics
Public Shared Function FromImage (image As Image) As Graphics
Parameter
Mengembalikan
Metode ini mengembalikan yang baru Graphics untuk Image.
Pengecualian
image adalah null.
image memiliki format piksel terindeks atau formatnya tidak ditentukan.
Contoh
Contoh kode berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:
Image Membuat dari file grafis SampImag.jpg di folder contoh.
Mengubah gambar dengan mengisi persegi panjang di dalamnya.
Menggambar ke Image layar.
Merilis yang dibuat Graphics.
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;
}
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
Keterangan
Jika gambar memiliki format piksel terindeks, metode ini melemparkan pengecualian dengan pesan, "Objek Grafis tidak dapat dibuat dari gambar yang memiliki format piksel terindeks." Format piksel terindeks diperlihatkan dalam daftar berikut.
Anda dapat menyimpan gambar terindeks sebagai format lain dengan menggunakan Save(String, ImageFormat) metode lalu mengambil Graphics objek untuk gambar baru.
Metode ini juga memberikan pengecualian jika gambar memiliki salah satu format piksel berikut.
Anda harus selalu memanggil Dispose metode untuk merilis dan sumber daya terkait yang GraphicsFromImage dibuat oleh metode .