Bitmap::SetPixel Method
Sets the color of the specified pixel in this Bitmap.
Namespace: System.Drawing
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- x
- Type: System::Int32
The x-coordinate of the pixel to set.
- y
- Type: System::Int32
The y-coordinate of the pixel to set.
- color
- Type: System.Drawing::Color
A Color structure that represents the color to assign to the specified pixel.
| Exception | Condition |
|---|---|
| Exception | The operation failed. |
The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:
Creates a Bitmap.
Sets the color of each pixel in the bitmap to black.
Draws the bitmap.
private: void SetPixel_Example( PaintEventArgs^ e ) { // Create a Bitmap object from a file. Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" ); // Draw myBitmap to the screen. e->Graphics->DrawImage( myBitmap, 0, 0, myBitmap->Width, myBitmap->Height ); // Set each pixel in myBitmap to black. for ( int Xcount = 0; Xcount < myBitmap->Width; Xcount++ ) { for ( int Ycount = 0; Ycount < myBitmap->Height; Ycount++ ) { myBitmap->SetPixel( Xcount, Ycount, Color::Black ); } } // Draw myBitmap to the screen again. e->Graphics->DrawImage( myBitmap, myBitmap->Width, 0, myBitmap->Width, myBitmap->Height ); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.