This documentation is archived and is not being maintained.

WriteableBitmap.WritePixels Method (Int32Rect, IntPtr, Int32, Int32, Int32, Int32)

Updates the pixels in the specified region of the bitmap.

Namespace:  System.Windows.Media.Imaging
Assembly:  PresentationCore (in PresentationCore.dll)

public void WritePixels(
	Int32Rect sourceRect,
	IntPtr sourceBuffer,
	int sourceBufferSize,
	int sourceBufferStride,
	int destinationX,
	int destinationY
)

Parameters

sourceRect
Type: System.Windows.Int32Rect
The rectangle in sourceBuffer to copy.
sourceBuffer
Type: System.IntPtr
The input buffer used to update the bitmap.
sourceBufferSize
Type: System.Int32
The size of the input buffer.
sourceBufferStride
Type: System.Int32
The stride of the input buffer, in bytes.
destinationX
Type: System.Int32
The destination x-coordinate of the left-most pixel in the back buffer.
destinationY
Type: System.Int32
The destination y-coordinate of the top-most pixel in the back buffer.

ExceptionCondition
ArgumentOutOfRangeException

One or more of the following conditions is true.

sourceRect falls outside the bounds of the WriteableBitmap.

destinationX or destinationY is outside the bounds of the WriteableBitmap.

sourceBufferSize < 1

sourceBufferStride < 1

ArgumentNullException

sourceBuffer is null.

Call the WritePixels method to update the WriteableBitmap automatically with the contents of sourceBuffer. Calling this method is the equivalent of using the Lock and Unlock workflow described in the WriteableBitmap class remarks.

NoteNote

In partial trust, use the WritePixels(Int32Rect, Array, Int32, Int32, Int32) overload.

.NET Framework

Supported in: 4, 3.5 SP1, 3.0 SP2

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: