CreatePolygonRgn 함수(wingdi.h)

아티클
08/27/2023

CreatePolygonRgn 함수는 다각형 영역을 만듭니다.

구문

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

매개 변수

[in] pptl

다각형의 꼭짓점을 논리 단위로 정의하는 POINT 구조체 배열에 대한 포인터입니다. 다각형은 닫힌 것으로 추정됩니다. 각 꼭짓점은 한 번만 지정할 수 있습니다.

[in] cPoint

배열의 점 수입니다.

[in] iMode

영역에 있는 픽셀을 결정하는 데 사용되는 채우기 모드입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
대체	대체 모드를 선택합니다(각 스캔 줄에서 홀수 번호가 매겨진 다각형과 짝수 다각형 면 사이의 영역을 채웁니다).
감기	권선 모드를 선택합니다(0이 아닌 권선 값으로 모든 영역을 채웁니다).

이러한 모드에 대한 자세한 내용은 SetPolyFillMode 함수를 참조하세요.

반환 값

함수가 성공하면 반환 값은 영역에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다.

설명

HRGN 개체가 더 이상 필요하지 않은 경우 DeleteObject 함수를 호출하여 삭제합니다.

영역 좌표는 27비트 부가 정수로 표시됩니다.

Create<shape>Rgn 메서드(예: CreateRectRgn 및 CreatePolygonRgn)에서 만든 영역에는 셰이프의 내부만 포함됩니다. 셰이프의 윤곽선은 영역에서 제외됩니다. 즉, 두 순차 꼭짓점 사이의 선에 있는 모든 지점이 영역에 포함되지 않습니다. 이러한 지점에 대해 PtInRegion 을 호출하는 경우 결과로 0을 반환합니다.

요구 사항


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