CDC::SetPixel

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定された点のピクセルに、crColor で指定される色に最も近い色を設定します。

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

パラメータ

x
設定する点の論理 x 座標。
y
設定する点の論理 y 座標。
crColor
点を描画するときに使う色を指定する COLORREF RGB 値。この値については、Windows SDK の「COLORREF」を参照してください。
point
設定する点の論理 x 座標および y 座標。このパラメータには、POINT 構造体または CPoint オブジェクトを渡すことができます。

戻り値

点が実際に描画されたときの色を RGB カラー値で返します。この値は、crColor で指定した値と類似した色が使われたときは、crColor で指定した値とは異なります。正常に実行されなかった場合 (点がクリップ領域の外にあるとき) は -1 を返します。

解説

点はクリップ領域内に存在する必要があります。点がクリップ領域内にないときは、関数は何も実行しません。

すべてのデバイスで SetPixel 関数がサポートされているわけではありません。デバイスが SetPixel 関数をサポートしているかどうかを調べるためには、RASTERCAPS インデックスを指定して GetDeviceCaps メンバ関数を呼び出し、戻り値の RC_BITBLT フラグをチェックしてください。