PtInRect 함수(winuser.h)

PtInRect 함수는 지정된 점이 지정된 사각형 내에 있는지 여부를 결정합니다. 점이 왼쪽 또는 위쪽에 있거나 네 면 모두에 있는 경우 사각형 내에 있습니다. 오른쪽 또는 아래쪽의 점이 사각형 외부로 간주됩니다.

구문

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

[in] lprc

지정된 사각형을 포함하는 RECT 구조체에 대한 포인터입니다.

[in] pt

지정된 점을 포함하는 POINT 구조체입니다.

지정한 점이 사각형 내에 있으면 반환 값은 0이 아닌 값입니다.

지정한 점이 사각형 내에 있지 않으면 반환 값은 0입니다.

PtInRect가 호출되기 전에 사각형을 정규화해야 합니다. 즉, lprc.right는 lprc.left보다 커야 하고 lprc.bottom는 lprc.top 보다 커야 합니다. 사각형이 정규화되지 않은 경우 사각형 내부에서 점이 고려되지 않습니다.

애플리케이션은 다양한 용도로 사각형을 사용할 수 있으므로 사각형 함수는 명시적 측정 단위를 사용하지 않습니다. 대신 모든 사각형 좌표와 차원은 서명된 논리 값으로 제공됩니다. 매핑 모드 및 사각형이 사용되는 함수는 측정 단위를 결정합니다.


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