ScrollWindowEx

지정 된 창 클라이언트 영역의 콘텐츠를 스크롤 하는 ScrollWindowEx 함수.

ScrollWindowEx ( int HWND  hWnd, / / 스크롤 창 핸들int dx, / / 양의 수평 스크롤int dy, / / 양의 수직 스크롤CONST RECT* prcScroll,  / 주소 / 스크롤 사각형 구조의CONST RECT* prcClip,  / 주소 / 클립 사각형 구조의HRGNhrgnUpdate, / / 지역 업데이트 처리LPRECTprcUpdate, / / 주소 업데이트 사각형에 대 한 구조UINT플래그 / / 스크롤 플래그);
 

매개 변수

hWnd
클라이언트 영역을 스크롤할 수는 창 핸들.
dx
수평 스크롤 장치 단위로, 금액을 지정합니다. 이 매개 변수 왼쪽으로 스크롤하고 음수 값 이어야 합니다.
dy
수직 스크롤 장치 단위로, 금액을 지정합니다. 이 매개 변수 위로 스크롤하려면 음수 값이 있어야 합니다.
prcScroll
포인터를 클라이언트 영역을 스크롤할 수의 부분을 지정 하는 RECT 구조체. 전체 클라이언트 영역을 스크롤할이 매개 변수가 NULL 인 경우.
prcClip
클리핑 사각형의 좌표가 들어 있는 RECT 구조체 포인터입니다. 클리핑 사각형 내에서 장치 비트만 영향을 받습니다. 비트 내부 사각형의 외부에서 스크롤됩니다 그린 있다; 사각형의 내부에서 밖으로 스크롤될 비트 색칠 하지.
hrgnUpdate
스크롤에 의해 무효로 하는 영역을 수정 되는 지역에 대 한 핸들. 이 매개 변수는 NULL이 될 수 있습니다.
prcUpdate
받은 스크롤에 의해 무효로 사각형의 경계 RECT 구조체 포인터입니다. 이 매개 변수는 NULL이 될 수 있습니다.
플래그
스크롤 제어 하는 플래그를 지정 합니다. 이 매개 변수는 다음 값 중 하나가 될 수 있습니다.:
의미
SW_ERASE SW_INVALIDATE 플래그와 함께 지정 하면 창에 WM_ERASEBKGND 메시지를 전송 하 여 새로 무효화 된 영역을 지웁니다.
SW_INVALIDATE 스크롤 후 hrgnUpdate 매개 변수에 의해 식별 된 영역을 무효화.
SW_SCROLLCHILDREN PrcScroll 매개 변수가 가리키는 사각형을 교차 하는 모든 자식 창을 스크롤합니다. 자식 창 dxdy 매개 변수에 의해 지정 된 픽셀 수 만큼 스크롤됩니다. 시스템 메시지를 보냅니다 WM_MOVE prcScroll 사각형을 교차 하는 모든 자식 창을 이동 하지 않습니다 경우에.
SW_SMOOTHSCROLL Windows NT 5.0 및 이후: 부드러운 스크롤을 사용 하 여 스크롤합니다. HIWORD 부분의 flags 매개 변수를 사용 하 여 부드러운 스크롤 작업 소요 되는 시간을 나타내는.

반환 값

함수가 성공 하면 반환 값은 SIMPLEREGION (사각형 무효화 된 지역), COMPLEXREGION (직사각형 무효화 된 영역; 겹치는 사각형), 또는 NULLREGION (무효화 된 지역).

함수가 실패 하면 반환 값은 오류. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

SW_INVALIDATE 및 SW_ERASE 플래그를 지정 하지 않으면 ScrollWindowEx 에서 스크롤 영역을 무효화 하는 것은 아닙니다. 이러한 플래그 중 하나를 설정 하는 경우 ScrollWindowEx 이 영역을 무효화 합니다. 영역 응용 프로그램 호출 될 때까지 업데이트 되지 않습니다를 UpdateWindow 기능, 호출에서 RedrawWindow (RDW_UPDATENOW 또는 RDW_ERASENOW 플래그를 지정 하면), 기능 또는 응용 프로그램 큐에서 WM_PAINT 메시지를 검색.

HrgnUpdateprcUpdate 에 의해 지정 된 반환 된 지역 대표 스크롤된 창 업데이트 해야 합니다, 업데이트 해야 하는 자식 창에 있는 모든 영역을 포함 하 여 총 면적 창 WS_CLIPCHILDREN 스타일 있으면.

SW_SCROLLCHILDREN 플래그를 지정 하는 경우 시스템 업데이트 되지 않습니다 제대로 화면 부분의 자식 창 스크롤 하는 경우. 소스 사각형을 벗어난 스크롤된 자식 창의 일부 지워지지 않습니다와 제대로 새로운 목적지에 그려질 하지. PrcScroll에 의해 지정 된 사각형 안에 완전히 거짓말 하지 않는 자식 창을 이동 하려면 DeferWindowPos 함수를 사용 합니다. SW_SCROLLCHILDREN 플래그를 설정 하 고 스크롤 사각형을 교차 하는 캐럿 사각형 커서 위치는.

모든 입력 및 출력 좌표 ( prcScroll, prcClip, prcUpdatehrgnUpdate) 창에 CS_OWNDC 또는 CS_CLASSDC 클래스 스타일에 있는지 여부에 관계 없이 클라이언트 좌표로 결정 됩니다. LPtoDPDPtoLP 함수를 사용 하 여 논리적 좌표 변환 필요한 경우.

Windows CE: Flags 매개 변수는 SW_SCROLLCHILDREN를 지원 하지 않습니다.

Dxdy 매개 변수 중 하나만 0이 아닌 수 있습니다.

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:버전 1.0 이상이 필요합니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 하 여.

참고 항목

스크롤 막대 개요, 스크롤 막대 기능, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow UpdateWindow

 

Index