영어로 읽기

다음을 통해 공유


WM_HSCROLL 메시지

WM_HSCROLL 메시지는 창의 표준 가로 스크롤 막대에서 스크롤 이벤트가 발생할 때 창으로 전송됩니다. 이 메시지는 컨트롤에서 스크롤 이벤트가 발생할 때 가로 스크롤 막대 컨트롤의 소유자에게도 전송됩니다.

창은 WindowProc 함수를 통해 이 메시지를 받습니다.

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam; 

매개 변수

wParam

HIWORDLOWORD가 SB_THUMBPOSITION 또는 SB_THUMBTRACK인 경우 스크롤 상자의 현재 위치를 지정합니다. 그렇지 않으면 이 단어는 사용되지 않습니다.

LOWORD는 사용자의 스크롤 요청을 나타내는 스크롤 막대 값을 지정합니다. 이 단어는 다음 값 중 하나일 수 있습니다.

의미
SB_ENDSCROLL
스크롤을 끝냅니다.
SB_LEFT
왼쪽 위까지 스크롤합니다.
SB_RIGHT
오른쪽 아래로 스크롤합니다.
SB_LINELEFT
한 단위 왼쪽으로 스크롤합니다.
SB_LINERIGHT
한 단위 오른쪽으로 스크롤합니다.
SB_PAGELEFT
창 너비를 기준으로 왼쪽으로 스크롤합니다.
SB_PAGERIGHT
창 너비를 기준으로 오른쪽으로 스크롤합니다.
SB_THUMBPOSITION
사용자가 스크롤 상자(엄지손가락)를 끌어 마우스 단추를 놓았습니다. HIWORD는 끌기 작업이 끝날 때 스크롤 상자의 위치를 나타냅니다.
SB_THUMBTRACK
사용자가 스크롤 상자를 끌고 있습니다. 이 메시지는 사용자가 마우스 단추를 놓을 때까지 반복해서 전송됩니다. HIWORD는 스크롤 상자를 끈 대상 위치를 나타냅니다.

lParam

스크롤 막대 컨트롤에서 메시지를 보낸 경우 이 매개 변수는 스크롤 막대 컨트롤에 대한 핸들입니다. 메시지가 표준 스크롤 막대로 전송되는 경우 이 매개 변수는 NULL입니다.

반환 값

애플리케이션이 이 메시지를 처리하면 0을 반환해야 합니다.

설명

SB_THUMBTRACK 요청 코드는 일반적으로 사용자가 스크롤 상자를 끌 때 피드백을 제공하는 애플리케이션에서 사용됩니다.

애플리케이션이 창의 콘텐츠를 스크롤하는 경우 SetScrollPos 함수를 사용하여 스크롤 상자의 위치도 초기화해야 합니다.

WM_HSCROLL 메시지는 스크롤 상자 위치 데이터의 16비트만 전달합니다. 따라서 스크롤 위치 데이터에 대해 WM_HSCROLL(및 WM_VSCROLL)에만 의존하는 애플리케이션의 실질적인 최대 위치 값은 65,535입니다.

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

요구 사항

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

추가 정보

참조

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL(트랙바)

WM_VSCROLL