SetPixel-Funktion (wingdi.h)

Artikel
03/13/2024

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