Share via


WriteableBitmap.WritePixels Methode

Definition

Aktualisiert die Pixel der Bitmap, in die geschrieben werden kann.

Überlädt

WritePixels(Int32Rect, Array, Int32, Int32)

Aktualisiert die Pixel im angegebenen Bereich der Bitmap.

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Aktualisiert die Pixel im angegebenen Bereich der Bitmap.

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

Aktualisiert die Pixel im angegebenen Bereich der Bitmap.

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

Aktualisiert die Pixel im angegebenen Bereich der Bitmap.

WritePixels(Int32Rect, Array, Int32, Int32)

Aktualisiert die Pixel im angegebenen Bereich der 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)

Parameter

sourceRect
Int32Rect

Das Rechteck der zu aktualisierenden WriteableBitmap.

pixels
Array

Das Pixelarray, das zum Aktualisieren der Bitmap verwendet wird.

stride
Int32

Der Schritt des Aktualisierungsbereichs in pixels.

offset
Int32

Der Offset des Eingabepuffers.

Attribute

Ausnahmen

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

stride< 1

offset< 0

pixels ist null.

pixels besitzt einen Rang ungleich 1 oder 2, oder seine Länge ist kleiner oder gleich 0.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie ein Pixel im Hintergrundpuffer mithilfe der WritePixels -Methode aktualisiert wird.

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

Hinweise

Die WritePixels(Int32Rect, Array, Int32, Int32, Int32) Überladungen und WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) werden gegenüber der Verwendung dieser Methode bevorzugt.

Hinweis

Verwenden Sie bei teilweiser Vertrauenswürdigstellung die WritePixels(Int32Rect, Array, Int32, Int32, Int32) -Überladung.

Gilt für:

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Aktualisiert die Pixel im angegebenen Bereich der 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)

Parameter

sourceRect
Int32Rect

Das Rechteck der zu aktualisierenden WriteableBitmap.

buffer
IntPtr

nativeint

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

bufferSize
Int32

Die Größe des Eingabepuffers.

stride
Int32

Der Schritt des Aktualisierungsbereichs in buffer.

Attribute

Ausnahmen

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

bufferSize< 1

stride< 1

buffer ist null.

Hinweise

Die WritePixels(Int32Rect, Array, Int32, Int32, Int32) Überladungen und WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) werden gegenüber der Verwendung dieser Methode bevorzugt.

Hinweis

Verwenden Sie bei teilweiser Vertrauenswürdigstellung die WritePixels(Int32Rect, Array, Int32, Int32, Int32) -Überladung.

Gilt für:

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

Aktualisiert die Pixel im angegebenen Bereich der 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)

Parameter

sourceRect
Int32Rect

Das zu kopierende Rechteck in sourceBuffer.

sourceBuffer
Array

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

sourceBufferStride
Int32

Der Schritt des Eingabepuffers in Bytes.

destinationX
Int32

Die Ziel-x-Koordinate des äußersten linken Pixel im Hintergrundpuffer.

destinationY
Int32

Die Ziel-y-Koordinate des äußersten oberen Pixel im Hintergrundpuffer.

Attribute

Ausnahmen

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

destinationX oder destinationY liegen außerhalb der Grenzen von WriteableBitmap.

sourceBufferStride< 1

sourceBuffer ist null.

sourceBuffer besitzt einen Rang ungleich 1 oder 2, oder seine Länge ist kleiner oder gleich 0.

Hinweise

Rufen Sie die WritePixels -Methode auf, um die WriteableBitmap automatisch mit dem Inhalt von sourceBufferzu aktualisieren. Das Aufrufen dieser Methode entspricht der Verwendung des in den Lock Klassenanmerkungen beschriebenen WriteableBitmap Workflows und Unlock .

Hinweis

Verwenden Sie diese Überladung in teilweiser Vertrauenswürdigstellung.

Weitere Informationen

Gilt für:

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

Aktualisiert die Pixel im angegebenen Bereich der 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)

Parameter

sourceRect
Int32Rect

Das zu kopierende Rechteck in sourceBuffer.

sourceBuffer
IntPtr

nativeint

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

sourceBufferSize
Int32

Die Größe des Eingabepuffers.

sourceBufferStride
Int32

Der Schritt des Eingabepuffers in Bytes.

destinationX
Int32

Die Ziel-x-Koordinate des äußersten linken Pixel im Hintergrundpuffer.

destinationY
Int32

Die Ziel-y-Koordinate des äußersten oberen Pixel im Hintergrundpuffer.

Attribute

Ausnahmen

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

destinationX oder destinationY liegen außerhalb der Grenzen von WriteableBitmap.

sourceBufferSize< 1

sourceBufferStride< 1

sourceBuffer ist null.

Hinweise

Rufen Sie die WritePixels -Methode auf, um die WriteableBitmap automatisch mit dem Inhalt von sourceBufferzu aktualisieren. Das Aufrufen dieser Methode entspricht der Verwendung des in den Lock Klassenanmerkungen beschriebenen WriteableBitmap Workflows und Unlock .

Hinweis

Verwenden Sie bei teilweiser Vertrauenswürdigstellung die WritePixels(Int32Rect, Array, Int32, Int32, Int32) -Überladung.

Weitere Informationen

Gilt für: