Graphics.FromImage(Image) Metoda

Definicja

Przestrzeń nazw:
System.Drawing
Zestaw:
System.Drawing.Common.dll
Zestaw:
System.Drawing.dll
Pakiet:
System.Drawing.Common v11.0.0-preview.3.26207.106
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Tworzy nowy Graphics element na podstawie określonego Imageelementu .

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

Parametry

image
Image

Image z którego chcesz utworzyć nowy Graphicselement .

Zwraca

Graphics

Ta metoda zwraca nowy Graphics element dla określonego Imageelementu .

Wyjątki

ArgumentNullException

Parametr image ma wartość null.

Exception

image ma indeksowany format pikseli lub jego format jest niezdefiniowany.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następującą akcję:

  • Tworzy element Image z pliku graficznego SampImag.jpg w przykładowym folderze.

  • Tworzy obiekt Graphics na podstawie elementu Image.

  • Zmienia obraz, wypełniając w nim prostokąt.

  • Rysuje ekran Image .

  • Zwalnia utworzony Graphicselement .

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

Uwagi

Jeśli obraz ma indeksowany format pikseli, ta metoda zgłasza wyjątek z komunikatem "Nie można utworzyć obiektu grafiki na podstawie obrazu, który ma indeksowany format pikseli". Formaty indeksowanych pikseli są wyświetlane na poniższej liście.

Możesz zapisać indeksowany obraz jako inny format przy użyciu Save(String, ImageFormat) metody , a następnie pobrać Graphics obiekt dla nowego obrazu.

Ta metoda zgłasza również wyjątek, jeśli obraz ma dowolny z następujących formatów pikseli.

Zawsze należy wywołać metodę Dispose , aby zwolnić Graphics powiązane zasoby i utworzone przez metodę FromImage .

Dotyczy

Zobacz też