ScrollDC 함수(winuser.h)

아티클
03/13/2024

ScrollDC 함수는 비트의 직사각형을 수평 및 수직으로 스크롤합니다.

구문

BOOL ScrollDC(
  [in]  HDC        hDC,
  [in]  int        dx,
  [in]  int        dy,
  [in]  const RECT *lprcScroll,
  [in]  const RECT *lprcClip,
  [in]  HRGN       hrgnUpdate,
  [out] LPRECT     lprcUpdate
);

매개 변수

[in] hDC

형식: HDC

스크롤할 비트가 포함된 디바이스 컨텍스트에 대한 핸들입니다.

[in] dx

형식: int

가로 스크롤의 양(디바이스 단위)을 지정합니다. 이 매개 변수는 왼쪽으로 스크롤하려면 음수 값이어야 합니다.

[in] dy

형식: int

세로 스크롤의 양(디바이스 단위)을 지정합니다. 이 매개 변수는 위로 스크롤하려면 음수 값이어야 합니다.

[in] lprcScroll

형식: const RECT*

스크롤할 비트의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다. 스크롤 작업의 영향을 받는 유일한 비트는 이 사각형의 교차에 있는 비트와 lprcClip으로 지정된 사각형입니다. lprcScroll이 NULL이면 전체 클라이언트 영역이 사용됩니다.

[in] lprcClip

형식: const RECT*

클리핑 사각형의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다. 그릴 비트는 스크롤 작업이 완료된 후 이 사각형 내에 남아 있는 비트뿐입니다. lprcClip이 NULL이면 전체 클라이언트 영역이 사용됩니다.

[in] hrgnUpdate

형식: HRGN

스크롤 프로세스에서 발견된 영역에 대한 핸들입니다. ScrollDC 는 이 지역을 정의합니다. 반드시 사각형은 아닙니다.

[out] lprcUpdate

형식: LPRECT

스크롤 업데이트 영역을 경계하는 사각형의 좌표를 받는 RECT 구조체에 대한 포인터입니다. 다시 그려야 하는 가장 큰 사각형 영역입니다. 함수가 반환될 때 구조체의 값은 지정된 디바이스 컨텍스트의 매핑 모드에 관계없이 클라이언트 좌표에 있습니다. 이를 통해 애플리케이션은 필요한 경우 InvalidateRgn 함수를 호출할 때 업데이트 영역을 사용할 수 있습니다.

반환 값

형식: BOOL

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

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

설명

lprcUpdate 매개 변수가 NULL이면 시스템에서 업데이트 사각형을 계산하지 않습니다. hrgnUpdate 및 lprcUpdate 매개 변수가 모두 NULL인 경우 시스템은 업데이트 지역을 계산하지 않습니다. hrgnUpdate가 NULL이 아닌 경우 시스템은 스크롤 프로세스(ScrollDC로 정의됨)에서 발견된 영역에 대한 유효한 핸들을 포함하는 것처럼 진행됩니다.

창의 전체 클라이언트 영역을 스크롤해야 하는 경우 ScrollWindowEx 함수를 사용합니다.

요구 사항

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