WriteableBitmap.WritePixels Método

Referência

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

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

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)

Parâmetros

sourceRect: Int32Rect

O retângulo do WriteableBitmap a ser atualizado.

pixels: Array

A matriz de pixel usada para atualizar o bitmap.

stride: Int32

A distância 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 está 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 tamanho é menor ou igual a 0.

Exemplos

O exemplo de código a seguir mostra como atualizar um pixel no buffer traseiro 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.

Observação

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

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)

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

A distância da região de atualização em buffer.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

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

sourceRect está 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.

Observação

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

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)

Parâmetros

sourceRect: Int32Rect

O retângulo no sourceBuffer a ser copiado.

sourceBuffer: Array

O buffer de entrada usado para atualizar o bitmap.

sourceBufferStride: Int32

A distância 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 ao topo no buffer de fundo.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

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

sourceRect está 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 tamanho é menor ou igual a 0.

Comentários

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

Observação

Use essa sobrecarga em 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);

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)

Parâmetros

sourceRect: Int32Rect

O retângulo no 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

A distância 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 ao topo no buffer de fundo.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

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

sourceRect está fora dos limites do WriteableBitmap.

destinationX ou destinationY está fora dos limites do WriteableBitmap.

sourceBufferSize < 1 sourceBufferStride < 1

ArgumentNullException

sourceBuffer é null.

Comentários

Observação

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

Confira também

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

Aplica-se a

Compartilhar via

WriteableBitmap.WritePixels Método

Definição

Sobrecargas

WritePixels(Int32Rect, Array, Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais