Freigeben über


SetPixel-Funktion (wingdi.h)

Die SetPixel-Funktion legt das Pixel an den angegebenen Koordinaten auf die angegebene Farbe fest.

Syntax

COLORREF SetPixel(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate in logischen Einheiten des festzulegenden Punkts.

[in] y

Die y-Koordinate in logischen Einheiten des festzulegenden Punkts.

[in] color

Die Farbe, die zum Zeichnen des Punkts verwendet werden soll. Um einen COLORREF-Farbwert zu erstellen, verwenden Sie das RGB-Makro .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der RGB-Wert, auf den die Funktion das Pixel festlegt. Dieser Wert kann von der von crColor angegebenen Farbe abweichen. tritt auf, wenn eine genaue Übereinstimmung für die angegebene Farbe nicht gefunden werden kann.

Wenn die Funktion fehlschlägt, ist der Rückgabewert -1.

Dies kann der folgende Wert sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
Mindestens ein Eingabeparameter ist ungültig.

Hinweise

Die Funktion schlägt fehl, wenn die Pixelkoordinaten außerhalb des aktuellen Beschneidungsbereichs liegen.

Nicht alle Geräte unterstützen die SetPixel-Funktion . Weitere Informationen finden Sie unter GetDeviceCaps.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h (einschließlich Windows.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV