Freigeben über


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

Weitere Informationen

Bitmap

Bitmap::LockBits

Bitmap::SetPixel

Farbe

Image

Bilder, Bitmaps und Metadateien

Verwenden von Bildern, Bitmaps und Metadateien