SetPixel 関数 (wingdi.h)

SetPixel 関数は、指定した座標のピクセルを指定した色に設定します。

構文

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

[in] hdc

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

[in] x

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

[in] y

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

[in] color

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

関数が成功した場合、戻り値は、関数がピクセルを設定する RGB 値です。この値は crColor で指定された色とは異なる場合があります。指定した色の完全一致が見つからない場合に発生します。

関数が失敗した場合、戻り値は -1 です。

次の値を指定できます。

リターンコード	説明
ERROR_INVALID_PARAMETER	1 つ以上の入力パラメーターが無効です。

ピクセル座標が現在のクリッピング領域の外側にある場合、関数は失敗します。

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

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