Freigeben über


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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

COLORREF

GetDeviceCaps

RGB

SetPixel