WriteableBitmap.WritePixels Methode

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 beschreibbaren Bitmap.

Überlädt

Name	Beschreibung
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 des WriteableBitmap zu aktualisierenden Inhalts.

pixels: Array

Das Pixelarray, das zum Aktualisieren der Bitmap verwendet wird.

stride: Int32

Der Schritt der Aktualisierungsregion in pixels.

offset: Int32

Der Eingabepufferoffset.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist wahr.

sourceRect liegt außerhalb der Grenzen der WriteableBitmap.

stride < 1

offset < 0

ArgumentNullException

pixels ist null.

ArgumentException

pixels hat einen anderen Rang als 1 oder 2, oder seine Länge ist kleiner oder gleich 0.

Beispiele

Das folgende Codebeispiel zeigt, 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) und WritePixels(Int32Rect, IntPtr, Int32, Int32, Int32, Int32) Überladungen werden gegenüber der Verwendung dieser Methode bevorzugt.

Note

Verwenden Sie die WritePixels(Int32Rect, Array, Int32, Int32, Int32) Überladung in teilweise vertrauenswürdiger Weise.

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 des WriteableBitmap zu aktualisierenden Inhalts.

buffer: IntPtr
nativeint

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

bufferSize: Int32

Die Größe des Eingabepuffers.

stride: Int32

Der Schritt der Aktualisierungsregion in buffer.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist wahr.

sourceRect liegt außerhalb der Grenzen der WriteableBitmap.

bufferSize < 1

stride < 1

ArgumentNullException

buffer ist null.

Hinweise

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

Note

Verwenden Sie die WritePixels(Int32Rect, Array, Int32, Int32, Int32) Überladung in teilweise vertrauenswürdiger Weise.

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 Rechteck, das sourceBuffer kopiert werden soll.

sourceBuffer: Array

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

sourceBufferStride: Int32

Die Stride des Eingabepuffers in Byte.

destinationX: Int32

Die X-Zielkoordinate des links am weitesten links im Hintergrundpuffer.

destinationY: Int32

Die Zielkoordinate des obersten Pixels im Hintergrundpuffer.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist wahr.

sourceRect liegt außerhalb der Grenzen der WriteableBitmap.

destinationX oder destinationY liegt außerhalb der Grenzen der WriteableBitmap.

sourceBufferStride < 1

ArgumentNullException

sourceBuffer ist null.

ArgumentException

sourceBuffer hat einen anderen Rang als 1 oder 2, oder seine Länge ist kleiner oder gleich 0.

Hinweise

Rufen Sie die WritePixels Methode auf, um die WriteableBitmap automatische Aktualisierung mit dem Inhalt von sourceBuffer. Das Aufrufen dieser Methode entspricht der Verwendung des Lock Unlock in den WriteableBitmap Klassenanmerkungen beschriebenen Workflows.

Note

Verwenden Sie diese Überladung in teilweiser Vertrauensstellung.

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 Rechteck, das sourceBuffer kopiert werden soll.

sourceBuffer: IntPtr
nativeint

Der Eingabepuffer, der zum Aktualisieren der Bitmap verwendet wird.

sourceBufferSize: Int32

Die Größe des Eingabepuffers.

sourceBufferStride: Int32

Die Stride des Eingabepuffers in Byte.

destinationX: Int32

Die X-Zielkoordinate des links am weitesten links im Hintergrundpuffer.

destinationY: Int32

Die Zielkoordinate des obersten Pixels im Hintergrundpuffer.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Mindestens eine der folgenden Bedingungen ist wahr.

sourceRect liegt außerhalb der Grenzen der WriteableBitmap.

destinationX oder destinationY liegt außerhalb der Grenzen der WriteableBitmap.

sourceBufferSize < 1

sourceBufferStride < 1

ArgumentNullException

sourceBuffer ist null.

Hinweise

Note

Verwenden Sie die WritePixels(Int32Rect, Array, Int32, Int32, Int32) Überladung in teilweise vertrauenswürdiger Weise.

Weitere Informationen

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

Gilt für:

Feedback

War diese Seite hilfreich?