GetScrollRange 함수(winuser.h)

아티클
08/27/2023

GetScrollRange 함수는 지정된 스크롤 막대의 현재 최소 및 최대 스크롤 상자(엄지) 위치를 검색합니다.

참고GetScrollRange 함수는 호환성을 위해서만 제공됩니다. 새 애플리케이션은 GetScrollInfo 함수를 사용해야 합니다.

구문

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

매개 변수

[in] hWnd

형식: HWND

nBar 매개 변수의 값에 따라 스크롤 막대 컨트롤 또는 표준 스크롤 막대가 있는 창에 대한 핸들입니다.

[in] nBar

형식: int

위치를 검색할 스크롤 막대를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
SB_CTL	스크롤 막대 컨트롤의 위치를 검색합니다. hWnd 매개 변수는 스크롤 막대 컨트롤에 대한 핸들이어야 합니다.
SB_HORZ	창의 표준 가로 스크롤 막대 위치를 검색합니다.
SB_VERT	창의 표준 세로 스크롤 막대 위치를 검색합니다.

[out] lpMinPos

형식: LPINT

최소 위치를 수신하는 정수 변수에 대한 포인터입니다.

[out] lpMaxPos

형식: LPINT

최대 위치를 수신하는 정수 변수에 대한 포인터입니다.

반환 값

형식: BOOL

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

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

설명

지정된 창에 표준 스크롤 막대가 없거나 스크롤 막대 컨트롤이 아닌 경우 GetScrollRange 함수는 lpMinPos 및 lpMaxPos 매개 변수에 0을 복사 합니다 .

표준 스크롤 막대의 기본 범위는 0~100입니다. 스크롤 막대 컨트롤의 기본 범위는 비어 있습니다(두 값 모두 0임).

스크롤 막대 위치( WM_HSCROLL 및 WM_VSCROLL)를 나타내는 메시지는 16비트 위치 데이터로 제한됩니다. 그러나 SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos 및 GetScrollRange 는 32비트 스크롤 막대 위치 데이터를 지원하므로 WM_HSCROLL 및 WM_VSCROLL 메시지의 16비트 장벽을 우회하는 방법이 있습니다. 기술에 대한 설명은 GetScrollInfo 함수를 참조하세요.

nBar 매개 변수가 SB_CTL hWnd 매개 변수로 지정된 창이 시스템 스크롤 막대 컨트롤이 아닌 경우 시스템은 SBM_GETRANGE 메시지를 창으로 보내 스크롤 막대 정보를 가져옵니다. 이렇게 하면 GetScrollRange 가 스크롤 막대를 모방하는 사용자 지정 컨트롤에서 작동할 수 있습니다. 창이 SBM_GETRANGE 메시지를 처리하지 않으면 GetScrollRange 함수가 실패합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll