SetPixelV 関数 (wingdi.h)

SetPixelV 関数は、指定した座標のピクセルを、指定した色の最も近い近似値に設定します。ポイントは、クリッピング領域とデバイスサーフェスの可視部分に存在する必要があります。

構文

BOOL SetPixelV(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

[in] hdc

デバイスコンテキストへのハンドル。

[in] x

設定するポイントの x 座標 (論理単位)。

[in] y

設定するポイントの y 座標 (論理単位)。

[in] color

ポイントの描画に使用する色。 COLORREF カラー値を作成するには、RGB マクロを使用します。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

すべてのデバイスで SetPixelV 関数がサポートされているわけではありません。詳細については、 GetDeviceCaps 関数のRC_BITBLT機能の説明を参照してください。

SetPixelV は、実際に塗りつぶされた点の色の値を返す必要がないため、 SetPixel よりも高速です。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll