Bitmap.Bitmap(String, Boolean) Constructor
Assembly: System.Drawing (in system.drawing.dll)
public Bitmap ( String filename, boolean useIcm )
public function Bitmap ( filename : String, useIcm : boolean )
Not applicable.
Parameters
- filename
The name of the bitmap file.
- useIcm
true to use color correction for this Bitmap; otherwise, false.
Use this constructor to open images with the following file formats: BMP, GIF, EXIG, JPG, PNG and TIFF. For more information about supported formats, see Types of Bitmaps. The file remains locked until the Bitmap is disposed.
The following code example demonstrates how to construct a new bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. It also uses the PixelFormat property.
This example is designed to be used with a Windows Form that contains a Label, PictureBox and Button named Label1, PictureBox1 and Button1, respectively. 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." ); } }
private Bitmap image1;
private void button1_Click(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.get_Width(); x++) {
for (y = 0; y < image1.get_Height(); y++) {
Color pixelColor = image1.GetPixel(x, y);
Color newColor = Color.FromArgb(pixelColor.get_R(), 0, 0);
image1.SetPixel(x, y, newColor);
}
}
// Set the PictureBox to display the image.
pictureBox1.set_Image(image1);
// Display the pixel format in label1.
label1.set_Text("Pixel format: "
+ image1.get_PixelFormat().ToString());
}
catch (ArgumentException exp) {
MessageBox.Show(("There was an error."
+ "Check the path to the image file."));
}
} //button1_Click
- SecurityPermission for calling into unmanaged code. Related enumeration: UnmanagedCode
Windows 98, Windows Server 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
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.