GetRandomRgn 함수(wingdi.h)

아티클
03/13/2024

GetRandomRgn 함수는 지정된 디바이스 컨텍스트의 시스템 클리핑 영역을 특정 지역에 복사합니다.

구문

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] hrgn

지역에 대한 핸들입니다. 함수가 호출되기 전에 기존 지역을 식별합니다. 함수가 반환된 후 현재 시스템 영역의 복사본을 식별합니다. hrgn으로 식별된 이전 지역을 덮어씁니다.

[in] i

이 매개 변수는 SYSRGN이어야 합니다.

반환 값

함수가 성공하면 반환 값은 1입니다. 함수가 실패하면 반환 값은 -1입니다. 검색할 지역이 NULL이면 반환 값은 0입니다. 함수가 실패하거나 검색할 지역이 NULL이면 hrgn 이 초기화되지 않습니다.

설명

SYSRGN 플래그를 사용하는 경우 창 이동으로 인해 시스템 클리핑 영역이 최신이 아닐 수 있습니다. 그럼에도 불구하고 WM_PAINT 처리하는 동안 BeginPaint EndPaint- 블록 내에서 시스템 클리핑 영역을 검색하고 사용하는 것이 안전합니다. 이 경우 시스템 영역은 업데이트 영역과 창의 현재 표시 영역의 교집합입니다. GetRandomRgn이 반환된 후 EndPaint 이전의 모든 창 이동은 새 WM_PAINT 메시지를 생성합니다. 다른 SYSRGN 플래그를 사용하면 애플리케이션에서 그리기 오류가 발생할 수 있습니다.

반환된 영역은 화면 좌표로 표시됩니다.

요구 사항

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