Graphics.FromImage(Image) 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v9.0.0-preview.6.24327.6

Source:

Graphics.cs

从指定的 Image创建新的 Graphics。

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

参数

image

Image

Image 从中创建新 Graphics。

返回

Graphics

此方法返回指定 Image的新 Graphics。

例外

ArgumentNullException

image null。

Exception

image 具有索引像素格式或其格式未定义。

示例

下面的代码示例设计用于 Windows 窗体，它需要 PaintEventArgse，这是 Paint 事件处理程序的参数。 该代码执行以下操作：

• 从示例文件夹中的图形文件 SampImag.jpg 创建 Image。

• 从 Image创建 Graphics。

• 通过在图像中填充矩形来更改图像。

• 将 Image 绘制到屏幕。

• 释放创建的 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

注解

如果图像具有索引像素格式，此方法将引发消息异常：“无法从具有索引像素格式的图像创建图形对象。索引像素格式显示在以下列表中。

• Format1bppIndexed

• Format4bppIndexed

• Format8bppIndexed

可以使用 Save(String, ImageFormat) 方法将索引图像保存为另一种格式，然后检索新图像的 Graphics 对象。

如果图像具有以下任何像素格式，此方法也会引发异常。

• Undefined

• DontCare

• Format16bppArgb1555

• Format16bppGrayScale

应始终调用 Dispose 方法来释放 FromImage 方法创建的 Graphics 和相关资源。

另请参阅

• 如何：在运行时创建位图
• 处理图像、位图、图标和图元文件
• 如何：为绘图 创建图形对象