WriteableBitmap.WritePixels Метод

Определение

Обновляет пиксели растрового изображения, доступного для записи.

Перегрузки

WritePixels(Int32Rect, Array, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

WritePixels(Int32Rect, Array, Int32, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

WritePixels(Int32Rect, Array, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

public:
 void WritePixels(System::Windows::Int32Rect sourceRect, Array ^ pixels, int stride, int offset);
[System.Security.SecurityCritical]
public void WritePixels (System.Windows.Int32Rect sourceRect, Array pixels, int stride, int offset);
public void WritePixels (System.Windows.Int32Rect sourceRect, Array pixels, int stride, int offset);
[<System.Security.SecurityCritical>]
member this.WritePixels : System.Windows.Int32Rect * Array * int * int -> unit
member this.WritePixels : System.Windows.Int32Rect * Array * int * int -> unit
Public Sub WritePixels (sourceRect As Int32Rect, pixels As Array, stride As Integer, offset As Integer)

Параметры

sourceRect
Int32Rect

Обновляемый прямоугольник растрового изображения WriteableBitmap.

pixels
Array

Массив пикселей, используемый для обновления растрового изображения.

stride
Int32

Шаг области обновления в pixels.

offset
Int32

Смещение входного буфера.

Атрибуты

Исключения

Одно или несколько из следующих условий истинно.

Параметр sourceRect выходит за пределы растрового изображения WriteableBitmap.

stride < 1 offset < 0

pixels имеет значение null.

Значение параметра pixels имеет ранг, отличный от 1 или 2, или его длина меньше или равна 0.

Примеры

В следующем примере кода показано, как обновить пиксель в заднем буфере WritePixels с помощью метода.

static void ErasePixel(MouseEventArgs e)
{
    byte[] ColorData = { 0, 0, 0, 0 }; // B G R

    Int32Rect rect = new Int32Rect(
            (int)(e.GetPosition(i).X), 
            (int)(e.GetPosition(i).Y), 
            1, 
            1);

    writeableBitmap.WritePixels( rect, ColorData, 4, 0);
}

Комментарии

WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) И WritePixels(Int32Rect, Array, Int32, Int32, Int32) перегрузки предпочтительнее использовать этот метод.

Примечание

В случае частичного доверия используйте перегрузку WritePixels(Int32Rect, Array, Int32, Int32, Int32) .

Применяется к

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

public:
 void WritePixels(System::Windows::Int32Rect sourceRect, IntPtr buffer, int bufferSize, int stride);
[System.Security.SecurityCritical]
public void WritePixels (System.Windows.Int32Rect sourceRect, IntPtr buffer, int bufferSize, int stride);
public void WritePixels (System.Windows.Int32Rect sourceRect, IntPtr buffer, int bufferSize, int stride);
[<System.Security.SecurityCritical>]
member this.WritePixels : System.Windows.Int32Rect * nativeint * int * int -> unit
member this.WritePixels : System.Windows.Int32Rect * nativeint * int * int -> unit
Public Sub WritePixels (sourceRect As Int32Rect, buffer As IntPtr, bufferSize As Integer, stride As Integer)

Параметры

sourceRect
Int32Rect

Обновляемый прямоугольник растрового изображения WriteableBitmap.

buffer
IntPtr

nativeint

Входной буфер, используемый для обновления растрового изображения.

bufferSize
Int32

Размер входного буфера.

stride
Int32

Шаг области обновления в buffer.

Атрибуты

Исключения

Одно или несколько из следующих условий истинно.

Параметр sourceRect выходит за пределы растрового изображения WriteableBitmap.

bufferSize < 1 stride < 1

buffer имеет значение null.

Комментарии

WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) И WritePixels(Int32Rect, Array, Int32, Int32, Int32) перегрузки предпочтительнее использовать этот метод.

Примечание

В случае частичного доверия используйте перегрузку WritePixels(Int32Rect, Array, Int32, Int32, Int32) .

Применяется к

WritePixels(Int32Rect, Array, Int32, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

public:
 void WritePixels(System::Windows::Int32Rect sourceRect, Array ^ sourceBuffer, int sourceBufferStride, int destinationX, int destinationY);
[System.Security.SecurityCritical]
public void WritePixels (System.Windows.Int32Rect sourceRect, Array sourceBuffer, int sourceBufferStride, int destinationX, int destinationY);
public void WritePixels (System.Windows.Int32Rect sourceRect, Array sourceBuffer, int sourceBufferStride, int destinationX, int destinationY);
[<System.Security.SecurityCritical>]
member this.WritePixels : System.Windows.Int32Rect * Array * int * int * int -> unit
member this.WritePixels : System.Windows.Int32Rect * Array * int * int * int -> unit
Public Sub WritePixels (sourceRect As Int32Rect, sourceBuffer As Array, sourceBufferStride As Integer, destinationX As Integer, destinationY As Integer)

Параметры

sourceRect
Int32Rect

Прямоугольник в sourceBuffer для копирования.

sourceBuffer
Array

Входной буфер, используемый для обновления растрового изображения.

sourceBufferStride
Int32

Шаг буфера входящих данных, в байтах.

destinationX
Int32

Конечная координата х крайнего левого пикселя в заднем буфере.

destinationY
Int32

Конечная координата y крайнего верхнего пикселя в заднем буфере.

Атрибуты

Исключения

Одно или несколько из следующих условий истинно.

Параметр sourceRect выходит за пределы растрового изображения WriteableBitmap.

Параметр destinationX или destinationY выходит за пределы растрового изображения WriteableBitmap.

sourceBufferStride < 1

sourceBuffer имеет значение null.

Значение параметра sourceBuffer имеет ранг, отличный от 1 или 2, или его длина меньше или равна 0.

Комментарии

WritePixels Вызовите метод для автоматического WriteableBitmap обновления содержимого sourceBuffer. Вызов этого метода эквивалентен использованию Lock рабочего процесса, Unlock описанного в WriteableBitmap примечаниях класса.

Примечание

Используйте эту перегрузку в частичном доверии.

См. также раздел

Применяется к

WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32)

Обновляет пиксели в заданной области растрового изображения.

public:
 void WritePixels(System::Windows::Int32Rect sourceRect, IntPtr sourceBuffer, int sourceBufferSize, int sourceBufferStride, int destinationX, int destinationY);
[System.Security.SecurityCritical]
public void WritePixels (System.Windows.Int32Rect sourceRect, IntPtr sourceBuffer, int sourceBufferSize, int sourceBufferStride, int destinationX, int destinationY);
public void WritePixels (System.Windows.Int32Rect sourceRect, IntPtr sourceBuffer, int sourceBufferSize, int sourceBufferStride, int destinationX, int destinationY);
[<System.Security.SecurityCritical>]
member this.WritePixels : System.Windows.Int32Rect * nativeint * int * int * int * int -> unit
member this.WritePixels : System.Windows.Int32Rect * nativeint * int * int * int * int -> unit
Public Sub WritePixels (sourceRect As Int32Rect, sourceBuffer As IntPtr, sourceBufferSize As Integer, sourceBufferStride As Integer, destinationX As Integer, destinationY As Integer)

Параметры

sourceRect
Int32Rect

Прямоугольник в sourceBuffer для копирования.

sourceBuffer
IntPtr

nativeint

Входной буфер, используемый для обновления растрового изображения.

sourceBufferSize
Int32

Размер входного буфера.

sourceBufferStride
Int32

Шаг буфера входящих данных, в байтах.

destinationX
Int32

Конечная координата х крайнего левого пикселя в заднем буфере.

destinationY
Int32

Конечная координата y крайнего верхнего пикселя в заднем буфере.

Атрибуты

Исключения

Одно или несколько из следующих условий истинно.

Параметр sourceRect выходит за пределы растрового изображения WriteableBitmap.

Параметр destinationX или destinationY выходит за пределы растрового изображения WriteableBitmap.

sourceBufferSize < 1 sourceBufferStride < 1

sourceBuffer имеет значение null.

Комментарии

WritePixels Вызовите метод для автоматического WriteableBitmap обновления содержимого sourceBuffer. Вызов этого метода эквивалентен использованию Lock рабочего процесса, Unlock описанного в WriteableBitmap примечаниях класса.

Примечание

В случае частичного доверия используйте перегрузку WritePixels(Int32Rect, Array, Int32, Int32, Int32) .

См. также раздел

Применяется к