Bitmap クラス

定義

GDI+ ビットマップをカプセル化します。このビットマップは、グラフィックス イメージのピクセル データとその属性で構成されます。Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. Bitmap は、ピクセル データで定義したイメージを処理する場合に使用するオブジェクトです。A Bitmap is an object used to work with images defined by pixel data.

public ref class Bitmap sealed : System::Drawing::Image
public sealed class Bitmap : System.Drawing.Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
継承
属性

次のコード例は、 Bitmap およびメソッドを使用してイメージの色を変更することにより、ファイルから新しいを構築する方法を示して GetPixel SetPixel います。The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. また、、、およびの各プロパティも使用し PixelFormat Width Height ます。It also uses the PixelFormat, Width, and Height properties.

この例は、、、およびという名前の、、およびをそれぞれ含む Windows フォームと共に使用するように設計されてい Label PictureBox Button Label1 PictureBox1 Button1 ます。This example is designed to be used with a Windows Forms that contains a Label, PictureBox, and Button named Label1, PictureBox1, and Button1, respectively. フォームにコードを貼り付け、メソッドを Button1_Click ボタンのイベントに関連付け Click ます。Paste the code into the form and associate the Button1_Click method with the button's Click event.

private:
   Bitmap^ image1;
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         
         // Retrieve the image.
         image1 = gcnew Bitmap( "C:\\Documents and Settings\\All Users\\"
         "Documents\\My Music\\music.bmp",true );
         int x;
         int y;
         
         // Loop through the images pixels to reset color.
         for ( x = 0; x < image1->Width; x++ )
         {
            for ( y = 0; y < image1->Height; y++ )
            {
               Color pixelColor = image1->GetPixel( x, y );
               Color newColor = Color::FromArgb( pixelColor.R, 0, 0 );
               image1->SetPixel( x, y, newColor );

            }

         }
         
         // Set the PictureBox to display the image.
         PictureBox1->Image = image1;
         
         // Display the pixel format in Label1.
         Label1->Text = String::Format( "Pixel format: {0}", image1->PixelFormat );
      }
      catch ( ArgumentException^ ) 
      {
         MessageBox::Show( "There was an error."
         "Check the path to the image file." );
      }

   }
Bitmap image1;

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    try
    {
        // Retrieve the image.
        image1 = new Bitmap(@"C:\Documents and Settings\All Users\" 
            + @"Documents\My Music\music.bmp", true);

        int x, y;

        // Loop through the images pixels to reset color.
        for(x=0; x<image1.Width; x++)
        {
            for(y=0; y<image1.Height; y++)
            {
                Color pixelColor = image1.GetPixel(x, y);
                Color newColor = Color.FromArgb(pixelColor.R, 0, 0);
                image1.SetPixel(x, y, newColor);
            }
        }

        // Set the PictureBox to display the image.
        PictureBox1.Image = image1;

        // Display the pixel format in Label1.
        Label1.Text = "Pixel format: "+image1.PixelFormat.ToString();
    }
    catch(ArgumentException)
    {
        MessageBox.Show("There was an error." +
            "Check the path to the image file.");
    }
}
Dim image1 As Bitmap

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    Try
        ' Retrieve the image.
        image1 = New Bitmap( _
            "C:\Documents and Settings\All Users\Documents\My Music\music.bmp", _
            True)

        Dim x, y As Integer

        ' Loop through the images pixels to reset color.
        For x = 0 To image1.Width - 1
            For y = 0 To image1.Height - 1
                Dim pixelColor As Color = image1.GetPixel(x, y)
                Dim newColor As Color = _
                    Color.FromArgb(pixelColor.R, 0, 0)
                image1.SetPixel(x, y, newColor)
            Next
        Next

        ' Set the PictureBox to display the image.
        PictureBox1.Image = image1

        ' Display the pixel format in Label1.
        Label1.Text = "Pixel format: " + image1.PixelFormat.ToString()

    Catch ex As ArgumentException
        MessageBox.Show("There was an error." _
            & "Check the path to the image file.")
    End Try
End Sub

注釈

ビットマップは、グラフィックスイメージのピクセルデータとその属性で構成されます。A bitmap consists of the pixel data for a graphics image and its attributes. ビットマップをファイルに保存するための標準形式は多数あります。There are many standard formats for saving a bitmap to a file. GDI+GDI+ では、BMP、GIF、EXIF、JPG、PNG、TIFF の各ファイル形式がサポートされています。supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. サポートされている形式の詳細については、「 ビットマップの種類」を参照してください。For more information about supported formats, see Types of Bitmaps.

コンストラクターの1つを使用してファイル、ストリーム、およびその他のソースからイメージを作成し、メソッドを使用して Bitmap ストリームまたはファイルシステムに保存することができ Save ます。You can create images from files, streams, and other sources by using one of the Bitmap constructors and save them to a stream or to the file system with the Save method. 画像は、オブジェクトのメソッドを使用して、画面またはメモリに描画され DrawImage Graphics ます。Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. イメージファイルの操作に関するトピックの一覧については、「 イメージ、ビットマップ、アイコン、およびメタファイルの操作」を参照してください。For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

注意

クラスは、 Bitmap アプリケーションドメイン間でアクセスできません。The Bitmap class is not accessible across application domains. たとえば、動的なを作成し、 AppDomain そのドメインに複数のブラシ、ペン、ビットマップを作成し、これらのオブジェクトをメインアプリケーションドメインに戻すと、ペンとブラシを正常に使用できるようになります。For example, if you create a dynamic AppDomain and create several brushes, pens, and bitmaps in that domain, then pass these objects back to the main application domain, you can successfully use the pens and brushes. ただし、メソッドを呼び出し DrawImage てマーシャリングされたを描画すると、 Bitmap 次の例外が発生します。However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

リモート処理で、型 "system.string" のフィールド "ネイティブイメージ" が見つかりません。Remoting cannot find field "native image" on type "System.Drawing.Image".

コンストラクター

Bitmap(Image)

指定した既存のイメージを使用して、Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

指定したサイズにスケールを設定して、指定した既存のイメージで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

指定したサイズにスケールを設定して、指定した既存のイメージで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

指定したサイズを使用して、Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

指定したサイズと指定した Graphics オブジェクトの解像度を使用して、Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class with the specified size and with the resolution of the specified Graphics object.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

指定したサイズ、ピクセル形式、ピクセル データを使用して、Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

指定したサイズと形式を使用して、Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

指定したデータ ストリームで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

指定したデータ ストリームで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

指定したファイルで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

指定したファイルで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

指定したリソースで Bitmap クラスの新しいインスタンスを初期化します。Initializes a new instance of the Bitmap class from a specified resource.

プロパティ

Flags

この Image のピクセル データに対する属性フラグを取得します。Gets attribute flags for the pixel data of this Image.

(継承元 Image)
FrameDimensionsList

この Image 内のフレームの大きさを表す GUID の配列を取得します。Gets an array of GUIDs that represent the dimensions of frames within this Image.

(継承元 Image)
Height

この Image の高さ (ピクセル単位) を取得します。Gets the height, in pixels, of this Image.

(継承元 Image)
HorizontalResolution

この Image の水平方向の解像度 (1 インチあたりのピクセル数) を取得します。Gets the horizontal resolution, in pixels per inch, of this Image.

(継承元 Image)
Palette

この Image に使用するカラー パレットを取得または設定します。Gets or sets the color palette used for this Image.

(継承元 Image)
PhysicalDimension

このイメージの幅と高さを取得します。Gets the width and height of this image.

(継承元 Image)
PixelFormat

この Image のピクセル形式を取得します。Gets the pixel format for this Image.

(継承元 Image)
PropertyIdList

この Image に格納されたプロパティ項目の ID を取得します。Gets IDs of the property items stored in this Image.

(継承元 Image)
PropertyItems

この Image に格納されたすべてのプロパティ項目 (メタデータの一部) を取得します。Gets all the property items (pieces of metadata) stored in this Image.

(継承元 Image)
RawFormat

この Image のファイル形式を取得します。Gets the file format of this Image.

(継承元 Image)
Size

このイメージの幅と高さ (ピクセル単位) を取得します。Gets the width and height, in pixels, of this image.

(継承元 Image)
Tag

イメージに関する追加データを提供するオブジェクトを取得または設定します。Gets or sets an object that provides additional data about the image.

(継承元 Image)
VerticalResolution

この Image の垂直方向の解像度 (1 インチあたりのピクセル数) を取得します。Gets the vertical resolution, in pixels per inch, of this Image.

(継承元 Image)
Width

この Image の幅 (ピクセル単位) を取得します。Gets the width, in pixels, of this Image.

(継承元 Image)

メソッド

Clone()

この Image の同一コピーを作成します。Creates an exact copy of this Image.

(継承元 Image)
Clone(Rectangle, PixelFormat)

Rectangle 構造体と、指定された PixelFormat 列挙体で定義された、この Bitmap のセクションのコピーを作成します。Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

指定された PixelFormat 列挙体で定義されたこの Bitmap のセクションのコピーを作成します。Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

この Image によって使用されているすべてのリソースを解放します。Releases all resources used by this Image.

(継承元 Image)
Dispose(Boolean)

Image によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(継承元 Image)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
FromHicon(IntPtr)

アイコンへの Windows ハンドルから Bitmap を作成します。Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

指定した Windows リソースから Bitmap を作成します。Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

指定した単位でイメージの境界を取得します。Gets the bounds of the image in the specified unit.

(継承元 Image)
GetEncoderParameterList(Guid)

指定したイメージ エンコーダーでサポートされるパラメーターについての情報を返します。Returns information about the parameters supported by the specified image encoder.

(継承元 Image)
GetFrameCount(FrameDimension)

指定したディメンションのフレームの数を返します。Returns the number of frames of the specified dimension.

(継承元 Image)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetHbitmap()

この Bitmap から GDIGDI ビットマップ オブジェクトを作成します。Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

この Bitmap から GDIGDI ビットマップ オブジェクトを作成します。Creates a GDIGDI bitmap object from this Bitmap.

GetHicon()

アイコンへのハンドルを返します。Returns the handle to an icon.

GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetPixel(Int32, Int32)

この Bitmap の指定したピクセルの色を取得します。Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

この Image の指定したプロパティ項目を取得します。Gets the specified property item from this Image.

(継承元 Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

この Image のサムネイルを返します。Returns a thumbnail for this Image.

(継承元 Image)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)

Bitmap をシステム メモリにロックします。Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Bitmap をシステム メモリにロックします。Locks a Bitmap into system memory.

MakeTransparent()

既定の透明色をこの Bitmap で透明します。Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

指定の透明色をこの Bitmap に使用します。Makes the specified color transparent for this Bitmap.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
RemovePropertyItem(Int32)

指定したプロパティ項目をこの Image から削除します。Removes the specified property item from this Image.

(継承元 Image)
RotateFlip(RotateFlipType)

Image の回転、反転、または回転と反転の両方を行います。Rotates, flips, or rotates and flips the Image.

(継承元 Image)
Save(Stream, ImageCodecInfo, EncoderParameters)

指定したエンコーダー パラメーターおよびイメージ エンコーダー パラメーターを使用して、このイメージを指定したストリームに保存します。Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(継承元 Image)
Save(Stream, ImageFormat)

このイメージを、指定した形式で指定したストリームに保存します。Saves this image to the specified stream in the specified format.

(継承元 Image)
Save(String)

この Image を指定したファイルまたはストリームに保存します。Saves this Image to the specified file or stream.

(継承元 Image)
Save(String, ImageCodecInfo, EncoderParameters)

指定したエンコーダー パラメーターとイメージ エンコーダー パラメーターを使用して、指定したファイルにこの Image を保存します。Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(継承元 Image)
Save(String, ImageFormat)

この Image を、指定した形式で指定したファイルに保存します。Saves this Image to the specified file in the specified format.

(継承元 Image)
SaveAdd(EncoderParameters)

前の Save メソッドの呼び出しで指定されたファイルまたはストリームにフレームを追加します。Adds a frame to the file or stream specified in a previous call to the Save method. このメソッドは、多重フレーム イメージから選択したフレームを別の多重フレーム イメージに保存する場合に使用します。Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(継承元 Image)
SaveAdd(Image, EncoderParameters)

前の Save メソッドの呼び出しで指定されたファイルまたはストリームにフレームを追加します。Adds a frame to the file or stream specified in a previous call to the Save method.

(継承元 Image)
SelectActiveFrame(FrameDimension, Int32)

ディメンションおよびインデックスで指定されたフレームを選択します。Selects the frame specified by the dimension and index.

(継承元 Image)
SetPixel(Int32, Int32, Color)

指定したピクセルの色を Bitmap で指定します。Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

この Image に、プロパティ項目 (メタデータの一部) を格納します。Stores a property item (piece of metadata) in this Image.

(継承元 Image)
SetResolution(Single, Single)

この Bitmap の解像度を設定します。Sets the resolution for this Bitmap.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)
UnlockBits(BitmapData)

システム メモリからこの Bitmap のロックを解除します。Unlocks this Bitmap from system memory.

明示的なインターフェイスの実装

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。Populates a SerializationInfo with the data needed to serialize the target object.

(継承元 Image)

適用対象

こちらもご覧ください