ScrollWindow 함수(winuser.h)

아티클
08/28/2023

ScrollWindow 함수는 지정된 창의 클라이언트 영역 콘텐츠를 스크롤합니다.

참고ScrollWindow 함수는 이전 버전과의 호환성을 위해 제공됩니다. 새 애플리케이션은 ScrollWindowEx 함수를 사용해야 합니다.

구문

BOOL ScrollWindow(
  [in] HWND       hWnd,
  [in] int        XAmount,
  [in] int        YAmount,
  [in] const RECT *lpRect,
  [in] const RECT *lpClipRect
);

매개 변수

[in] hWnd

형식: HWND

클라이언트 영역을 스크롤할 창에 대한 핸들입니다.

[in] XAmount

형식: int

가로 스크롤의 양(디바이스 단위)을 지정합니다. 스크롤되는 창에 CS_OWNDC 또는 CS_CLASSDC 스타일이 있는 경우 이 매개 변수는 디바이스 단위가 아닌 논리 단위를 사용합니다. 창 내용을 왼쪽으로 스크롤하려면 이 매개 변수가 음수 값이어야 합니다.

[in] YAmount

형식: int

세로 스크롤의 양(디바이스 단위)을 지정합니다. 스크롤되는 창에 CS_OWNDC 또는 CS_CLASSDC 스타일이 있는 경우 이 매개 변수는 디바이스 단위가 아닌 논리 단위를 사용합니다. 이 매개 변수는 창의 내용을 위로 스크롤하려면 음수 값이어야 합니다.

[in] lpRect

형식: const RECT*

스크롤할 클라이언트 영역의 부분을 지정하는 RECT 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 전체 클라이언트 영역이 스크롤됩니다.

[in] lpClipRect

형식: const RECT*

클리핑 사각형의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다. 클리핑 사각형 내의 디바이스 비트만 영향을 받습니다. 사각형 바깥쪽에서 안쪽으로 스크롤된 비트가 그려집니다. 사각형 내부에서 외부로 스크롤된 비트는 그려지지 않습니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

스크롤되는 창에 있는 경우 ScrollWindow 는 자동으로 캐리트를 숨겨 지울 수 없도록 한 다음 스크롤이 완료된 후 케어를 복원합니다. 캐리트 위치는 그에 따라 조정됩니다.

ScrollWindow에서 발견된 영역은 다시 칠해지지 않지만 창의 업데이트 영역에 결합됩니다. 애플리케이션은 결국 지역을 다시 그려야 한다는 WM_PAINT 메시지를 받습니다. 스크롤이 작동하는 동시에 발견된 영역을 다시 그리려면 ScrollWindow를 호출한 직후 UpdateWindow 함수를 호출합니다.

lpRect 매개 변수가 NULL이면 창에 있는 자식 창의 위치가 XAmount 및 YAmount 매개 변수에 지정된 양만큼 오프셋됩니다. 창의 유효하지 않은 영역도 오프셋됩니다. lpRect가 NULL이면 ScrollWindow가 더 빠릅니다.

lpRect가 NULL이 아니면 자식 창의 위치가 변경되지 않고 창의 잘못된 영역이 오프셋되지 않습니다. lpRect가 NULL이 아닌 경우 업데이트 문제를 방지하려면 ScrollWindow를 호출하기 전에 UpdateWindow를 호출하여 창을 다시 칠합니다.

예제

예를 들어 WM_PAINT 메시지를 사용하여 텍스트 스크롤을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-4(Windows 10 버전 10.0.14393에 도입됨)