SetPixelV-Funktion (wingdi.h)

Artikel
03/13/2024

Die SetPixelV-Funktion legt das Pixel an den angegebenen Koordinaten auf die nächstgelegene Näherung der angegebenen Farbe fest. Der Punkt muss sich im Abschneidebereich und im sichtbaren Teil der Geräteoberfläche befinden.

Syntax

BOOL SetPixelV(
  [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 ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Nicht alle Geräte unterstützen die SetPixelV-Funktion . Weitere Informationen finden Sie in der Beschreibung der RC_BITBLT-Funktion in der GetDeviceCaps-Funktion .

SetPixelV ist schneller als SetPixel , da der Farbwert des tatsächlich gezeichneten Punkts nicht zurückgegeben werden muss.

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