Bitmap.GetPixel Method (System.Drawing)

MSDN Library
.NET Development
.NET Framework 3.5
.NET Framework Class Library
System.Drawing Namespace
Bitmap Class
Bitmap Methods

Clone Method
Dispose Method
FromHicon Method
FromResource Method
GetHbitmap Method
GetHicon Method

GetPixel Method

LockBits Method
MakeTransparent Method
MemberwiseClone Method
Save Method
SaveAdd Method
SetPixel Method
SetResolution Method
UnlockBits Method

Related Links

Bitmap Class
Brush Class
Brushes Class
BufferedGraphics Class
BufferedGraphicsContext Class
BufferedGraphicsManager Class
CharacterRange Structure
Color Structure
ColorConverter Class
ColorTranslator Class
ContentAlignment Enumeration
CopyPixelOperation Enumeration
Font Class
FontConverter Class
FontConverter.FontNameConverter Class
FontConverter.FontUnitConverter Class
FontFamily Class
FontStyle Enumeration
Graphics Class
Graphics.DrawImageAbort Delegate
Graphics.EnumerateMetafileProc Delegate
GraphicsUnit Enumeration
Icon Class
IconConverter Class
IDeviceContext Interface
Image Class
Image.GetThumbnailImageAbort Delegate
ImageAnimator Class
ImageConverter Class
ImageFormatConverter Class
KnownColor Enumeration
Pen Class
Pens Class
Point Structure
PointConverter Class
PointF Structure
Rectangle Structure
RectangleConverter Class
RectangleF Structure
Region Class
RotateFlipType Enumeration
Size Structure
SizeConverter Class
SizeF Structure
SizeFConverter Class
SolidBrush Class
StringAlignment Enumeration
StringDigitSubstitute Enumeration
StringFormat Class
StringFormatFlags Enumeration
StringTrimming Enumeration
StringUnit Enumeration
SystemBrushes Class
SystemColors Class
SystemFonts Class
SystemIcons Class
SystemPens Class
TextureBrush Class
ToolboxBitmapAttribute Class

Bitmap..::.GetPixel Method
This page is specific to:.NET Framework Version:1.1 2.0 3.03.54.0

.NET Framework Class Library

Bitmap..::.GetPixel Method

Gets the color of the specified pixel in this Bitmap.

Namespace: System.Drawing
Assembly: System.Drawing (in System.Drawing.dll)

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim instance As Bitmap
Dim x As Integer
Dim y As Integer
Dim returnValue As Color

returnValue = instance.GetPixel(x, y)

'Declaration

Public Function GetPixel ( _
    x As Integer, _
    y As Integer _
) As Color

Parameters

x: Type: System..::.Int32
The x-coordinate of the pixel to retrieve.

y: Type: System..::.Int32
The y-coordinate of the pixel to retrieve.

Return Value

Type: System.Drawing..::.Color
A Color structure that represents the color of the specified pixel.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	x is less than 0, or greater than or equal to Width. or y is less than 0, or greater than or equal to Height
Exception	The operation failed.

Exception

Condition

ArgumentOutOfRangeException

x is less than 0, or greater than or equal to Width.

y is less than 0, or greater than or equal to Height

Exception

The operation failed.

Examples

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 gets the color of a pixel in a bitmap, and then fills a rectangle with that color.

C++

JScript

Copy to Clipboard Print

Private Sub GetPixel_Example(ByVal e As PaintEventArgs)

    ' Create a Bitmap object from an image file.
    Dim myBitmap As New Bitmap("Grapes.jpg")

    ' Get the color of a pixel within myBitmap.
    Dim pixelColor As Color = myBitmap.GetPixel(50, 50)

    ' Fill a rectangle with pixelColor.
    Dim pixelBrush As New SolidBrush(pixelColor)
    e.Graphics.FillRectangle(pixelBrush, 0, 0, 100, 100)
End Sub

Platforms

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

Reference

Bitmap Class

Bitmap Members

System.Drawing Namespace