SetPixelV-Funktion (wingdi.h)
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 |