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) .