WriteableBitmap.WritePixels Methode

Referenz

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

stride < 1

offset < 0

ArgumentNullException

pixels ist null.

ArgumentException

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: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist erfüllt.

sourceRect liegt außerhalb der Grenzen von WriteableBitmap.

bufferSize < 1

stride < 1

ArgumentNullException

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: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

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

ArgumentNullException

sourceBuffer ist null.

ArgumentException

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

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

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: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

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

ArgumentNullException

sourceBuffer ist null.

Hinweise

Hinweis

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

Weitere Informationen

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

Gilt für:

Freigeben über

WriteableBitmap.WritePixels Methode

Definition

Überlädt

WritePixels(Int32Rect, Array, Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

WritePixels(Int32Rect, IntPtr, Int32, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen