Bitmap::SetPixel-Methode (gdiplusheaders.h)

Artikel
02/26/2024

Die Bitmap::SetPixel-Methode legt die Farbe eines angegebenen Pixels in dieser Bitmap fest.

Syntax

Status SetPixel(
  [in]      INT           x,
  [in]      INT           y,
  [in, ref] const Color & color
);

Parameter

[in] x

Typ: INT

int , das die x-Koordinate (Spalte) des Pixels angibt.

[in] y

Typ: INT

int , das die y-Koordinate (Zeile) des Pixels angibt.

[in, ref] color

Typ: const Color

Verweis auf ein Color-Objekt , das die festzulegende Farbe angibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Abhängig vom Format der Bitmap gibt Bitmap::GetPixel möglicherweise nicht denselben Wert zurück, der von Bitmap::SetPixel festgelegt wurde. Wenn Sie beispielsweise Bitmap::SetPixel für ein Bitmap-Objekt aufrufen, dessen Pixelformat 32bppPARGB ist, werden die RGB-Komponenten vorab multipliziert. Ein nachfolgender Aufruf von Bitmap::GetPixel gibt aufgrund von Rundung möglicherweise einen anderen Wert zurück. Wenn Sie Bitmap::SetPixel für eine Bitmap aufrufen, deren Farbtiefe 16 Bit pro Pixel beträgt, können bei der Konvertierung von 32 zu 16 Bit Informationen verloren gehen, und ein späterer Aufruf von Bitmap::GetPixel gibt möglicherweise einen anderen Wert zurück.

Beispiele

Im folgenden Beispiel wird ein Bitmap-Objekt basierend auf einer JPEG-Datei erstellt. Der Code zeichnet die Bitmap, sobald sie unverändert ist. Anschließend ruft der Code die Bitmap::SetPixel-Methode auf, um ein überprüftes Muster aus schwarzen Pixeln in der Bitmap zu erstellen und die geänderte Bitmap zu zeichnet.

VOID Example_SetPixel(HDC hdc)

{
   Graphics graphics(hdc);

   // Create a Bitmap object from a JPEG file.
   Bitmap myBitmap(L"Climber.jpg");

   // Draw the bitmap.
   graphics.DrawImage(&myBitmap, 0, 0);

   // Create a checkered pattern with black pixels.
   for (UINT row = 0; row < myBitmap.GetWidth(); row += 2)
   {
      for (UINT col = 0; col < myBitmap.GetHeight(); col += 2)
      {
         myBitmap.SetPixel(row, col, Color(255, 0, 0, 0));
      }
   }

   // Draw the altered bitmap.
   graphics.DrawImage(&myBitmap, 200, 0);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll