SetWindowRgn

SetWindowRgn

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

int SetWindowRgn(
    HWND hWnd,        // 윈도우 핸들
    HRGN hRgn,        // 리젼 핸들
    BOOL fRedraw      // 재묘화 플래그
);

USER32.DLL

인수

hWnd

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

hRgn

리젼의 핸들을 지정합니다.이 파라미터로 지정된 리젼이 윈도우 리젼으로 설정됩니다.

이 파라미터에 0 (NULL) (을)를 지정하면, 윈도우 리젼은 NULL (으)로 설정됩니다.

fRedraw

윈도우 리젼이 설정된 후에 시스템이 윈도우를 재묘화 할지를 지정합니다. 1 (TRUE) (을)를 지정하면, 윈도우가 재묘화 됩니다. 0 (FALSE) (을)를 지정하면, 재묘화 되지 않습니다.

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.

Windows NT/2000/XP： 확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

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

SetWindowRgn 함수가 성공하면, 시스템은, 리젼의 카피를 작성하지 않고 , hRgn 파라미터로 지정된 리젼을 소유합니다.따라서, 이 리젼 핸들을 다른 리젼 조작 함수에 건네줄 수 없습니다.특히, 리젼 핸들을 삭제 해서는 안됩니다.이 리젼은, 필요하지 않게 되었을 때에 시스템에 의해서 삭제됩니다.

윈도우의 윈도우 리젼을 취득하려면 , GetWindowRgn 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후