Auf Englisch lesen

Freigeben über


Bitmap.SetPixel(Int32, Int32, Color) Methode

Definition

Legt die Farbe des angegebenen Pixels in diesem Bitmapfest.

C#
public void SetPixel(int x, int y, System.Drawing.Color color);

Parameter

x
Int32

Die x-Koordinate des festzulegenden Pixels.

y
Int32

Die y-Koordinate des festzulegenden Pixels.

color
Color

Eine Color Struktur, die die Farbe darstellt, die dem angegebenen Pixel zugewiesen werden soll.

Ausnahmen

Fehler beim Vorgang.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine Bitmap.

  • Legt die Farbe der einzelnen Pixel in der Bitmap auf Schwarz fest.

  • Zeichnet die Bitmap.

C#
private void SetPixel_Example(PaintEventArgs e)
{

    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");

    // Draw myBitmap to the screen.
    e.Graphics.DrawImage(myBitmap, 0, 0, myBitmap.Width,
        myBitmap.Height);

    // Set each pixel in myBitmap to black.
    for (int Xcount = 0; Xcount < myBitmap.Width; Xcount++)
    {
        for (int Ycount = 0; Ycount < myBitmap.Height; Ycount++)
        {
            myBitmap.SetPixel(Xcount, Ycount, Color.Black);
        }
    }

    // Draw myBitmap to the screen again.
    e.Graphics.DrawImage(myBitmap, myBitmap.Width, 0,
        myBitmap.Width, myBitmap.Height);
}

Hinweise

Verwenden Sie SetPixel Methode, um die Farbe eines einzelnen Pixels in einem Bild programmgesteuert festzulegen. Sie können ein Bild auch programmgesteuert mithilfe der LockBits-Methode ändern. In der Regel bietet die LockBits Methode eine bessere Leistung.

Gilt für:

Produkt Versionen
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10