DOBON.NET プログラミング道: .NET Framework, VB.NET, C#, Visual Basic, Visual Studio, インストーラ, ...

• ピクチャボックスに簡単に画像を表示する
  • PictureBox.Imageプロパティを使用する
    • 画像の配置方法を指定する
  • .NET Framework 2.0以降で、指定した場所の画像を表示する
  • BackgroundImageプロパティを使用する

ピクチャボックスに簡単に画像を表示する

PictureBox.Imageプロパティを使用する

ピクチャボックスに画像を表示させる場合、一番簡単な方法は、PictureBoxのImageプロパティに表示するイメージを指定することです。次の例ではこの方法により、ピクチャボックスPictureBox1に画像ファイル"C:\Blue hills.jpg"を表示させています。

[VB.NET]
PictureBox1.Image = Image.FromFile("C:\Blue hills.jpg")

[C#]
PictureBox1.Image = Image.FromFile(@"C:\Blue hills.jpg");

また、このようにして表示した画像を消去するには、次のようにします。

[VB.NET]
If Not (PictureBox1.Image Is Nothing) Then
    PictureBox1.Image.Dispose()
    PictureBox1.Image = Nothing
End If

[C#]
if (PictureBox1.Image != null) 
{
    PictureBox1.Image.Dispose();
    PictureBox1.Image = null;
}

なお、ピクチャボックスに画像を描画する最も一般的な方法は、「画像ファイルを表示する」で紹介します。

画像の配置方法を指定する

PictureBox.Imageプロパティで表示する画像の配置方法を指定するには、PictureBox.SizeModeプロパティを使います。SizeModeプロパティに指定できるPictureBoxSizeMode構造体のメンバを以下に示します。何も指定しなければNormalとなります。

次の例では、画像ファイル"C:\Blue hills.jpg"をPictureBox1の大きさに合わせて表示させるようにしています。

[VB.NET]
'画像の大きさをPictureBoxに合わせる
PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
'画像を表示する
PictureBox1.Image = Image.FromFile("C:\Blue hills.jpg")

[C#]
//画像の大きさをPictureBoxに合わせる
PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
//画像を表示する
PictureBox1.Image = Image.FromFile(@"C:\Blue hills.jpg");

.NET Framework 2.0以降で、指定した場所の画像を表示する

.NET Framework 2.0からは、PictureBox.ImageLocationプロパティを使って、指定したURIの画像をPictureBoxに表示することができます。この方がImageプロパティによる方法よりも簡単です。

ImageLocationプロパティで読み込んだ画像は、Imageプロパティに設定されます。

以下に画像ファイル"C:\test.bmp"を表示する例を示します。ImageLocationに"C:\test.bmp"のようなパスを指定しても大丈夫ですが、下の例のように、"file:///"とする方法が推奨されています。

[VB.NET]
'PictureBox1に"C:\test.bmp"を表示する
PictureBox1.ImageLocation = "file:///C:/test.bmp"

[C#]
//PictureBox1に"C:\test.bmp"を表示する
PictureBox1.ImageLocation = "file:///C:/test.bmp";

ImageLocationプロパティについてさらに詳しくは、「ピクチャボックスで非同期的に画像を読み込み、表示する」で説明します。

BackgroundImageプロパティを使用する

画像を表示する目的で使用するのは適当ではありませんが、Control.BackgroundImageプロパティにより、画像を表示することもできます。この場合は通常、画像が並べれられ表示されます。

.NET Framework 2.0からはControl.BackgroundImageLayoutプロパティにより、背景画像の配置法を変更することができます。BackgroundImageLayoutプロパティに指定できるImageLayout列挙体のメンバを以下に示します。

BackgroundImageLayoutをZoomにして背景画像を設定する例を以下に示します。

[VB.NET]
PictureBox1.BackgroundImageLayout = ImageLayout.Zoom
PictureBox1.BackgroundImage = Image.FromFile("C:\Blue hills.jpg")

[C#]
PictureBox1.BackgroundImageLayout = ImageLayout.Zoom;
PictureBox1.BackgroundImage = Image.FromFile(@"C:\Blue hills.jpg");

• 関連：
• 画像ファイルを表示する
• PictureBoxのImageプロパティに関するよくある勘違い

• 履歴：
• 2007/1/15 「.NET Framework 2.0以降で、指定したURLの画像を表示する」と「BackgroundImageプロパティを使用する」を追加。