Graphics.FromImage メソッド

.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)

C#

public static Graphics FromImage (
    Image image
)

C++

public:
static Graphics^ FromImage (
    Image^ image
)

J#

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間