Bitmap::SetPixel-Methode (gdiplusheaders.h)
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 |