CreateRectRgn 함수(wingdi.h)

아티클
03/13/2024

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

구문

HRGN CreateRectRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

매개 변수

[in] x1

영역의 왼쪽 위 모서리에 대한 x 좌표를 논리 단위로 지정합니다.

[in] y1

영역의 왼쪽 위 모서리에 대한 y 좌표를 논리 단위로 지정합니다.

[in] x2

영역 오른쪽 아래 모서리의 x 좌표를 논리 단위로 지정합니다.

[in] y2

영역 오른쪽 아래 모서리의 y 좌표를 논리 단위로 지정합니다.

반환 값

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

함수가 실패하면 반환 값은 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