Partager via


CDC::SetPixel

Définit le pixel au point spécifié à l'approximation la plus proche de la couleur spécifiée par crColor.

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

Paramètres

  • x
    Spécifie la coordonnée x logique du point à définir.

  • y
    Spécifie l'ordonnée logique du point à définir.

  • crColor
    Une valeur RVB de COLORREF qui spécifie la couleur utilisée pour peindre le débogage.Consultez COLORREF dans Kit de développement logiciel Windows pour obtenir une description de cette valeur.

  • point
    Spécifie les coordonnées x et y logique du point à définir.Vous pouvez passer une structure de POINT ou un objet d' CPoint pour ce paramètre.

Valeur de retour

Une valeur RVB pour la couleur que le point est peint en fait.Cette valeur peut être différente de celle spécifiée par crColor si une approximation de cette couleur est utilisée.Si la fonction échoue (si le point est à l'extérieur de la région de découpage), la valeur de retour est à 1.

Notes

Le point doit être dans la région de découpage.Si le débogage n'est pas dans la région de découpage, la fonction ne fait rien.

Tous les appareils prennent en charge la fonction d' SetPixel .Pour déterminer si l'application le prend en charge des appareils SetPixel, appelez la fonction membre d' GetDeviceCaps de l'index de RASTERCAPS et examinent la valeur de retour pour rechercher la balise de RC_BITBLT .

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::GetDeviceCaps

CDC::GetPixel

SetPixel

POINT, structure

Classe de CPoint