CWnd::ScrollWindowEx

아티클
02/21/2013

창의 클라이언트 영역의 내용을 스크롤합니다.

int ScrollWindowEx(
   int dx,
   int dy,
   LPCRECT lpRectScroll,
   LPCRECT lpRectClip,
   CRgn* prgnUpdate,
   LPRECT lpRectUpdate,
   UINT flags 
);

매개 변수

dx
크기, 가로 스크롤 장치 단위로 지정합니다.이 매개 변수는 음수 값은 왼쪽으로 스크롤하려면 있어야 합니다.
dy
세로 스크롤 장치 단위로 지정합니다.이 매개 변수는 음수 값을 스크롤할 수 있어야 합니다.
lpRectScroll
가리키는 있는 RECT 클라이언트 영역을 스크롤할 수 있는 부분을 지정 하는 구조입니다.이 매개 변수가 NULL, 전체 클라이언트 영역을 스크롤할.
lpRectClip
가리키는 있는 RECT 스크롤 클리핑 사각형을 지정 하는 구조입니다.이 구조에서 가리키는 사각형 우선 lpRectScroll.이 사각형 안에 있는 비트만 스크롤됩니다.비트가이 사각형 외부에 있는 경우에 영향을 받지 않습니다는 lpRectScroll 사각형.이 매개 변수가 NULL, 클리핑이 스크롤 사각형에서 수행 됩니다.
prgnUpdate
로 무효화 된 영역을 보유 하는 수정 된 영역을 식별 합니다.이 매개 변수 수 NULL.
lpRectUpdate
가리키는 있는 RECT 구조로 무효화 된 사각형의 경계를 받게 됩니다.이 매개 변수 수 NULL.
flags
다음 값 중 하나를 사용할 수 있습니다.
- SW_ERASE 를 지정 하면 SW_INVALIDATE를 보내 새로 무효화 된 영역을 지우는 WM_ERASEBKGND 메시지 창.
- SW_INVALIDATE 로 영역을 무효화 prgnUpdate 스크롤 후.
- SW_SCROLLCHILDREN 가 가리키는 사각형을 교차 하는 모든 자식 창을 스크롤합니다 lpRectScroll 에 지정 된 픽셀 수 만큼 dx 및 dy.보내는 Windows는 WM_MOVE 메시지를 교차 하는 모든 자식 창은 lpRectScroll, 이동 하지 않습니다 경우에.자식 창이 스크롤 커서 사각형이 스크롤 사각형을 교차 하는 경우 캐럿 위치가 바뀌었습니다.

반환 값

반환 값이 SIMPLEREGION (사각형 무효화 된 영역)에서 COMPLEXREGION (무효화 된 영역이 사각형이 아닌. 겹치는 사각형), 또는 NULLREGION (무효화 된 영역), 함수, 성공적으로입니다. 그렇지 않으면 반환 값이 오류.

설명

이 함수가 유사는 ScrollWindow 일부 추가 기능 함수.

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

창에 있을 경우는 WS_CLIPCHILDREN 스타일, 반환 된 영역이 지정 된 prgnUpdate 및 lpRectUpdate 를 업데이트 해야 하는 하위 창에 모든 영역을 포함 하 여 업데이트 해야 하는 스크롤 창의 전체 영역을 나타내는.

경우는 SW_SCROLLCHILDREN 플래그를 지정 하 고 Windows 올바르게 업데이트 하지 않습니다 화면 하위 창의 부분으로 스크롤하면 됩니다.소스 사각형 외부에 있는 스크롤된 자식 창의 부품 지워지게 됩니다 및 새 대상으로 제대로 새로 그려지지 않습니다.사용은 DeferWindowPos Windows 기능을 완전히 내에 있지 않는 자식 창 이동 하는 lpRectScroll 사각형.커서의 경우 위치가 변경 되는 SW_SCROLLCHILDREN 플래그를 설정 하 고 캐럿 사각형이 스크롤 사각형을 교차 합니다.

모든 입력 및 출력 좌표 (에 대 한 lpRectScroll, lpRectClip, lpRectUpdate, 및 prgnUpdate) 클라이언트 좌표는 창이 있는지 여부에 관계 없이 간주 됩니다의 CS_OWNDC 또는 CS_CLASSDC 클래스 스타일.사용은 LPtoDP 및 DPtoLP 필요한 경우와 논리적 좌표를 변환 하는 Windows 기능입니다.