Share via

SBM_GETSCROLLINFO 메시지

  • 아티클

스크롤 막대의 매개 변수를 검색하기 위해 SBM_GETSCROLLINFO 메시지가 전송됩니다.

애플리케이션에서 이 메시지를 직접 보내면 안 됩니다. 대신 GetScrollInfo 함수를 사용해야 합니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 사용자 지정 스크롤 막대 컨트롤을 구현하는 애플리케이션은 GetScrollInfo 함수가 제대로 작동하려면 이러한 메시지에 응답해야 합니다.

매개 변수

wParam

이 매개 변수는 사용되지 않습니다.

lParam

SCROLLINFO 구조체를 가리키는 포인터입니다. GetScrollInfo를 호출하기 전에 구조체의 cbSize 멤버를 sizeof(SCROLLINFO)로 설정하고 fMask 멤버를 설정하여 검색할 스크롤 막대 매개 변수를 지정합니다. 반환하기 전에 메시지는 지정된 매개 변수를 구조체의 적절한 멤버에 복사합니다.

fMask 멤버는 다음 값 중 하나 이상일 수 있습니다.

값 의미
SIF_ALL
 SIF_PAGE, SIF_POS, SIF_RANGE 및 SIF_TRACKPOS의 조합입니다.
SIF_PAGE
 스크롤 페이지를 nPage 멤버에 복사합니다.
SIF_POS
 스크롤 위치를 nPos 멤버에 복사합니다.
SIF_RANGE
 스크롤 범위를 nMin 및 nMax 멤버에 복사합니다.
SIF_TRACKPOS
 현재 스크롤 상자 추적 위치를 nTrackPos 멤버에 복사합니다.

반환 값

메시지가 값을 검색한 경우 반환 값은 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

스크롤 막대 위치(WM_HSCROLL 및 WM_VSCROLL)를 나타내는 메시지는 16비트의 위치 데이터만 제공합니다. 그러나 SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo, SetScrollInfo에서 사용하는 SCROLLINFO 구조체는 32비트의 스크롤 막대 위치 데이터를 제공합니다. WM_HSCROLL 또는 WM_VSCROLL 메시지를 처리하는 동안 이러한 메시지와 함수를 사용하여 32비트의 스크롤 막대 위치 데이터를 가져올 수 있습니다.

WM_HSCROLL 또는 WM_VSCROLL 메시지에서 SB_THUMBTRACK 요청 코드 중에 스크롤 상자(엄지)의 32비트 위치를 가져오려면 SCROLLINFO 구조체의 fMask 멤버에 SIF_TRACKPOS 값을 사용하는 SBM_GETSCROLLINFO를 보냅니다. 이 메시지는 SCROLLINFO 구조체의 nTrackPos 멤버에 있는 스크롤 상자의 추적 위치를 반환합니다. 이렇게 하면 사용자가 스크롤 상자를 이동할 때 스크롤 상자의 위치를 가져올 수 있습니다. 또는 GetScrollInfo 함수를 사용하여 동일한 정보를 가져올 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Winuser.h(Windows.h 포함)

추가 정보

참조

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo