GetWindowRgn

GetWindowRgn

지정된 윈도우의 윈도우 리젼의 카피를 취득합니다.윈도우 리젼은, 시스템이 묘화를 허가하는 윈도우내의 영역을 결정합니다.시스템은, 윈도우 리젼으로부터 빗나가는 윈도우의 부분을 표시하지 않습니다.

int GetWindowRgn(
    HWND hWnd,        // 윈도우 핸들
    HRGN hRgn         // 리젼 핸들
);

USER32.DLL

인수

hWnd

윈도우 리젼을 취득하는 윈도우의 핸들을 지정합니다.

hRgn

리젼의 핸들을 지정합니다.이 파라미터로 지정된 리젼이 윈도우 리젼을 나타내도록(듯이) 변경됩니다.

반환값

취득된 리젼의 형식을 나타내는 값이 돌아갑니다.이하의 값의 어느 쪽인가에 됩니다.

치	의미
0 (ERROR)	지정된 윈도우는 리젼을 가지고 있지 않습니다.또는, 리젼 취득중에 에러가 발생했습니다.
1 (NULLREGION)	하늘의 리젼이 취득되었습니다.
2 (SIMPLEREGION)	1개의 장방형으로부터 되는 리젼이 취득되었습니다.
3 (COMPLEXREGION)	1개의 장방형보다 복잡한 형태의 리젼이 취득되었습니다.

해설

윈도우 리젼의 좌표는 윈도우의 클라이언트 에리어가 아니고, 윈도우의 좌상구석으로부터의 상대적인 좌표로 나타내집니다.

윈도우의 윈도우 리젼을 설정하려면 , SetWindowRgn 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후