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:
[SecurityCriticalAttribute]
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.

Exception Condition
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.

System_CAPS_noteNote

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

SecurityPermission

for access to unmanaged resources. Security action: Demand. Associated enumeration: SecurityPermissionFlag::UnmanagedCode

.NET Framework
Available since 3.0
Return to top
Show: