다음을 통해 공유


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

추가 정보

비트맵 함수

비트맵 개요

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV