Freigeben über


CDC::SetPixel

Legt das Pixel am Punkt fest, der zur nächsten Schätzwert der Farbe angegeben wird, die von crColor angegeben wird.

COLORREF SetPixel( 
   int x, 
   int y, 
   COLORREF crColor  
); 
COLORREF SetPixel( 
   POINT point, 
   COLORREF crColor  
);

Parameter

  • x
    Gibt die logische x-Koordinate des festgelegt werden an Punkts.

  • y
    Gibt die logische y-Koordinate des festgelegt werden an Punkts.

  • crColor
    Ein Wert COLORREF RGB, der die Farbe angibt, die verwendet wird, um den Punkt zu zeichnen. Siehe COLORREF in Windows SDK für eine Beschreibung dieses Werts.

  • point
    Gibt das logische x- und y-Koordinaten für festgelegt werden an Punkts. Sie können eine POINT-Struktur oder ein CPoint-Objekt für diesen Parameter übergeben.

Rückgabewert

Ein RGB-Wert für die Farbe, dass der Punkt tatsächlich gezeichnet wird. Dieser Wert kann zum unterscheiden, der von crColor angegeben wird, wenn ein Schätzwert dieser Farbe verwendet wird. Wenn die Funktion fehlschlägt (wenn der Punkt außerhalb des Clippingbereichs ist), ist der Rückgabewert - 1.

Hinweise

Der Punkt muss im Clippingbereich sein. Wenn der Punkt nicht im Clippingbereich ist, führt die Funktion nichts.

Nicht alle Geräte unterstützen die SetPixel-Funktion. Um nach gewünschtem ein Gerät SetPixel unterstützt, rufen Sie die GetDeviceCaps-Memberfunktion mit dem RASTERCAPS Index auf und überprüfen Sie den Rückgabewert für das RC_BITBLT-Flag.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

POINT-Struktur

CPoint Class