WriteableBitmap.WritePixels Método

Definição

Espaço de Nomes:: System.Windows.Media.Imaging

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Atualiza os píxeis do bitmap gravável.

Sobrecargas

Name	Description
WritePixels(Int32Rect, Array, Int32, Int32)	Atualiza os píxeis na região especificada do bitmap.
WritePixels(Int32Rect, IntPtr, Int32, Int32)	Atualiza os píxeis na região especificada do bitmap.
WritePixels(Int32Rect, Array, Int32, Int32, Int32)	Atualiza os píxeis na região especificada do bitmap.
WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32)	Atualiza os píxeis na região especificada do bitmap.

WritePixels(Int32Rect, Array, Int32, Int32)

Atualiza os píxeis na região especificada do bitmap.

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

[<System.Security.SecurityCritical>]
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)

Parâmetros

sourceRect: Int32Rect

O retângulo do WriteableBitmap para atualizar.

pixels: Array

O array de píxeis usado para atualizar o bitmap.

stride: Int32

O passo da região de atualização em pixels.

offset: Int32

O deslocamento do buffer de entrada.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições é verdadeira.

sourceRect fica fora dos limites do WriteableBitmap.

stride < 1

offset < 0

ArgumentNullException

pixels é null.

ArgumentException

pixels tem um posto diferente de 1 ou 2, ou o seu comprimento é menor ou igual a 0.

Exemplos

O exemplo de código seguinte mostra como atualizar um pixel no back buffer usando o WritePixels método.

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);
}

Observações

As WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecargas e WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) são preferidas em relação a este método.

Note

Em confiança parcial, usa a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Aplica-se a

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Atualiza os píxeis na região especificada do bitmap.

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

[<System.Security.SecurityCritical>]
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)

Parâmetros

sourceRect: Int32Rect

O retângulo do WriteableBitmap para atualizar.

buffer: IntPtr
nativeint

O buffer de entrada usado para atualizar o bitmap.

bufferSize: Int32

O tamanho do buffer de entrada.

stride: Int32

O passo da região de atualização em buffer.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições é verdadeira.

sourceRect fica fora dos limites do WriteableBitmap.

bufferSize < 1

stride < 1

ArgumentNullException

buffer é null.

Observações

As WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecargas e WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) são preferidas em relação a este método.

Note

Em confiança parcial, usa a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Aplica-se a

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

Atualiza os píxeis na região especificada do bitmap.

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

[<System.Security.SecurityCritical>]
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)

Parâmetros

sourceRect: Int32Rect

O retângulo para sourceBuffer copiar.

sourceBuffer: Array

O buffer de entrada usado para atualizar o bitmap.

sourceBufferStride: Int32

O passo do buffer de entrada, em bytes.

destinationX: Int32

A coordenada x de destino do pixel mais à esquerda no buffer de trás.

destinationY: Int32

A coordenada y de destino do píxel mais alto no buffer de trás.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições é verdadeira.

sourceRect fica fora dos limites do WriteableBitmap.

destinationX ou destinationY está fora dos limites do WriteableBitmap.

sourceBufferStride < 1

ArgumentNullException

sourceBuffer é null.

ArgumentException

sourceBuffer tem um posto diferente de 1 ou 2, ou o seu comprimento é menor ou igual a 0.

Observações

Chame o WritePixels método para atualizar automaticamente o WriteableBitmap com o conteúdo de sourceBuffer. Chamar este método equivale a usar o Lock fluxo de trabalho e Unlock descrito nas WriteableBitmap observações da classe.

Note

Usa esta sobrecarga com confiança parcial.

Ver também

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

Aplica-se a

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

Atualiza os píxeis na região especificada do bitmap.

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

[<System.Security.SecurityCritical>]
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)

Parâmetros

sourceRect: Int32Rect

O retângulo para sourceBuffer copiar.

sourceBuffer: IntPtr
nativeint

O buffer de entrada usado para atualizar o bitmap.

sourceBufferSize: Int32

O tamanho do buffer de entrada.

sourceBufferStride: Int32

O passo do buffer de entrada, em bytes.

destinationX: Int32

A coordenada x de destino do pixel mais à esquerda no buffer de trás.

destinationY: Int32

A coordenada y de destino do píxel mais alto no buffer de trás.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições é verdadeira.

sourceRect fica fora dos limites do WriteableBitmap.

destinationX ou destinationY está fora dos limites do WriteableBitmap.

sourceBufferSize < 1

sourceBufferStride < 1

ArgumentNullException

sourceBuffer é null.

Observações

Note

Em confiança parcial, usa a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Ver também

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

Aplica-se a

Comentários

Esta página foi útil?