WriteableBitmap.WritePixels Método

Definição

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Atualiza os pixels do bitmap gravável.

Sobrecargas

Nome	Description
WritePixels(Int32Rect, Array, Int32, Int32)	Atualiza os pixels na região especificada do bitmap.
WritePixels(Int32Rect, IntPtr, Int32, Int32)	Atualiza os pixels na região especificada do bitmap.
WritePixels(Int32Rect, Array, Int32, Int32, Int32)	Atualiza os pixels na região especificada do bitmap.
WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32)	Atualiza os pixels na região especificada do bitmap.

WritePixels(Int32Rect, Array, Int32, Int32)

Atualiza os pixels 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 a ser atualizado.

pixels: Array

A matriz de pixels usada 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 são verdadeiras.

sourceRect cai fora dos limites do WriteableBitmap.

stride < 1

offset < 0

ArgumentNullException

pixels é null.

ArgumentException

pixels tem uma classificação diferente de 1 ou 2, ou seu comprimento é menor ou igual a 0.

Exemplos

O exemplo de código a seguir mostra como atualizar um pixel no buffer de fundo 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);
}

Comentários

As WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecargas e as WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) sobrecargas são preferenciais em vez de usar esse método.

Note

Na confiança parcial, use a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Aplica-se a

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Atualiza os pixels 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 a ser atualizado.

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 são verdadeiras.

sourceRect cai fora dos limites do WriteableBitmap.

bufferSize < 1

stride < 1

ArgumentNullException

buffer é null.

Comentários

As WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecargas e as WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) sobrecargas são preferenciais em vez de usar esse método.

Note

Na confiança parcial, use a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Aplica-se a

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

Atualiza os pixels 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 sourceBuffer a ser copiado.

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

destinationY: Int32

A coordenada y de destino do pixel mais alto no buffer de fundo.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições são verdadeiras.

sourceRect cai fora dos limites do WriteableBitmap.

destinationX ou destinationY está fora dos limites do WriteableBitmap.

sourceBufferStride < 1

ArgumentNullException

sourceBuffer é null.

ArgumentException

sourceBuffer tem uma classificação diferente de 1 ou 2, ou seu comprimento é menor ou igual a 0.

Comentários

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

Note

Use essa sobrecarga na confiança parcial.

Confira também

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

Aplica-se a

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

Atualiza os pixels 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 sourceBuffer a ser copiado.

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

destinationY: Int32

A coordenada y de destino do pixel mais alto no buffer de fundo.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

Uma ou mais das seguintes condições são verdadeiras.

sourceRect cai fora dos limites do WriteableBitmap.

destinationX ou destinationY está fora dos limites do WriteableBitmap.

sourceBufferSize < 1

sourceBufferStride < 1

ArgumentNullException

sourceBuffer é null.

Comentários

Note

Na confiança parcial, use a WritePixels(Int32Rect, Array, Int32, Int32, Int32) sobrecarga.

Confira também

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

Aplica-se a

Comentários

Esta página foi útil?