Graphics.FromImage メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Graphics.FromImage メソッド

指定した Image の新しい Graphics を作成します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FromImage
 ( _
    image As Image _
) As Graphics

Visual Basic (使用法)

Dim image As Image
Dim returnValue As Graphics

returnValue = Graphics.FromImage(image)

public static Graphics FromImage (
    Image image
)

C++

public:
static Graphics^ FromImage (
    Image^ image
)

public static Graphics FromImage (
    Image image
)

JScript

public static function FromImage
 (
    image : Image
) : Graphics

パラメータ

image: 新しい Graphics の作成元の Image。

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

例外

例外の種類	条件
ArgumentNullException	image が null 参照 (Visual Basic では Nothing) です。
Exception	image がインデックス付きのピクセル形式であるか、またはその形式が未定義です。

解説

イメージがインデックス付きのピクセル形式の場合、このメソッドは "インデックス付きのピクセル形式をもつイメージから Graphics オブジェクトを作成することはできません。" というメッセージと共に例外をスローします。インデックス付きのピクセル形式の一覧を次に示します。

Format1bppIndexed
Format4bppIndexed
Format8bppIndexed

このメソッドは、イメージが次のピクセル形式の場合にも例外をスローします。

Undefined
DontCare
Format16bppArgb1555
Format16bppGrayScale

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

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベントハンドラのパラメータである PaintEventArgse が必要です。このコードでは次のアクションを実行します。

サンプル用のフォルダにあるグラフィックスファイル SampImag.jpg から Image を作成します。
Image から Graphics を作成します。
内部の四角形を塗りつぶしてイメージを変更します。
画面に Image を描画します。
作成された Graphics を解放します。

Visual Basic

Public 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

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(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();
}