다음을 통해 공유


CWnd::ScrollWindowEx

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

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_INVALIDATESW_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 클래스 스타일. 사용은 LPtoDPDPtoLP 필요한 경우와 논리적 좌표를 변환 하는 Windows 기능입니다.

요구 사항

헤더: afxwin.h

참고 항목

참조

CWnd 클래스

계층 구조 차트

CWnd::RedrawWindow

CDC::ScrollDC

CWnd::ScrollWindow

CWnd::UpdateWindow

DeferWindowPos

ScrollWindowEx