Graphics.FromImage(Image) メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-rc.2.24474.1

ソース:

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

新しい Graphicsを作成する場所を Image します。

戻り値

Graphics

このメソッドは、指定した Imageの新しい Graphics を返します。

例外

ArgumentNullException

image は nullです。

Exception

インデックス付きピクセル形式を持つ image、またはその形式が未定義です。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードでは、次のアクションが実行されます。

• サンプル フォルダー内のグラフィックス ファイル 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

注釈

イメージにインデックス付きピクセル形式がある場合、このメソッドは"A Graphics object cannot be created from a image that has an indexed pixel format" (グラフィックス オブジェクトはインデックス付きピクセル形式の画像から作成できません) というメッセージで例外をスローします。インデックス付きピクセル形式を次の一覧に示します。

• Format1bppIndexed

• Format4bppIndexed

• Format8bppIndexed

Save(String, ImageFormat) メソッドを使用してインデックス付きイメージを別の形式で保存し、新しいイメージの Graphics オブジェクトを取得できます。

このメソッドは、画像に次のいずれかのピクセル形式がある場合にも例外をスローします。

• Undefined

• DontCare

• Format16bppArgb1555

• Format16bppGrayScale

FromImage メソッドによって作成された Graphics と関連リソースを解放するには、常に Dispose メソッドを呼び出す必要があります。

こちらもご覧ください

• 方法: 実行時にビットマップを作成する
• 画像、ビットマップ、アイコン、メタファイルの操作
• 方法: 描画 用のグラフィックス オブジェクトを作成する