CDC::SetPixelV

[アーティクル]
08/09/2011

指定された座標にあるピクセルを、指定された色に最も近い色に設定します。

BOOL SetPixelV(
   int x,
   int y,
   COLORREF crColor
);
BOOL SetPixelV(
   POINT point,
   COLORREF crColor 
);

パラメーター

x
設定する点の x 座標 (論理単位)。
y
設定する点の y 座標 (論理単位)。
crColor
点を描画するときに使う色。
point
設定する点の論理 x 座標および y 座標。このパラメーターには、POINT データ構造体または CPoint オブジェクトを渡すことができます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

点は、クリップ領域と、デバイス表面の表示される部分の両方の内側にある必要があります。すべてのデバイスで、このメンバー関数がサポートされるわけではありません。詳細については、CDC::GetDeviceCaps メンバー関数の RC_BITBLT 機能の説明を参照してください。実際に塗りつぶされた点のカラー値を返す必要がないため、SetPixelV の方が SetPixel よりも高速に処理できます。