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	하나 이상의 입력 매개 변수가 잘못되었습니다.

픽셀 좌표가 현재 클리핑 영역 외부에 있으면 함수가 실패합니다.

모든 디바이스가 SetPixel 함수를 지원하는 것은 아닙니다. 자세한 내용은 GetDeviceCaps를 참조하세요.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll