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 Graphics baru untuk Imageyang ditentukan.
Pengecualian
image
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:
Membuat Image dari file grafik SampImag.jpg di folder contoh.
Mengubah gambar dengan mengisi persegi panjang di dalamnya.
Menggambar Image ke layar.
Merilis Graphicsyang dibuat.
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 metode Save(String, ImageFormat) lalu mengambil objek Graphics untuk gambar baru.
Metode ini juga memberikan pengecualian jika gambar memiliki salah satu format piksel berikut.
Anda harus selalu memanggil metode Dispose untuk merilis Graphics dan sumber daya terkait yang dibuat oleh metode FromImage.