Bitmap::GetPixel-Methode (gdiplusheaders.h)
Die Bitmap::GetPixel-Methode ruft die Farbe eines angegebenen Pixels in dieser Bitmap ab.
Syntax
Status GetPixel(
[in] INT x,
[in] INT y,
[out] Color *color
);
Parameter
[in] x
Typ: INT
Ganzzahl, die die x-Koordinate (Spalte) des Pixels angibt.
[in] y
Typ: INT
Ganze Zahl, die die y-Koordinate (Zeile) des Pixels angibt.
[out] color
Typ: Farbe*
Zeiger auf ein Color-Objekt , das die Farbe des angegebenen Pixels empfängt.
Rückgabewert
Typ: Status
Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .
Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.
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 des Pixels vormultipliziert. Ein nachfolgender Aufruf von Bitmap::GetPixel kann aufgrund der Rundung einen anderen Wert zurückgeben. Wenn Sie Bitmap::SetPixel für ein Bitmap-Objekt aufrufen, dessen Farbtiefe 16 Bit pro Pixel beträgt, können informationen während der Konvertierung von 32 zu 16 Bit 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 ruft die Bitmap::GetPixel-Methode auf, um die Farbe eines Pixels in der Bitmap abzurufen, und füllt dann ein Rechteck mit der abgerufenen Farbe.
VOID Example_GetPixel(HDC hdc)
{
Graphics graphics(hdc);
// Create a Bitmap object from a JPEG file.
Bitmap myBitmap(L"Climber.jpg");
// Get the value of a pixel from myBitmap.
Color pixelColor;
myBitmap.GetPixel(25, 25, &pixelColor);
// Fill a rectangle with the pixel color.
SolidBrush brush(pixelColor);
graphics.FillRectangle(&brush, Rect(0, 0, 100, 100));
}
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 |