SetScrollInfo 함수(winuser.h)

  • 아티클

SetScrollInfo 함수는 최소 및 최대 스크롤 위치, 페이지 크기, 스크롤 상자(엄지)의 위치를 포함하여 스크롤 막대의 매개 변수를 설정합니다. 또한 이 함수는 요청된 경우 스크롤 막대를 다시 그립니다.

구문

int SetScrollInfo(
  [in] HWND          hwnd,
  [in] int           nBar,
  [in] LPCSCROLLINFO lpsi,
  [in] BOOL          redraw
);

매개 변수

[in] hwnd

형식: HWND

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

[in] nBar

형식: int

매개 변수를 설정할 스크롤 막대의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

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

[in] lpsi

형식: LPCSCROLLINFO

SCROLLINFO 구조체를 가리키는 포인터입니다. SetScrollInfo를 호출하기 전에 구조체의 cbSize 멤버를 sizeof(SCROLLINFO)로 설정하고, fMask 멤버를 설정하여 설정할 매개 변수를 지정하며, 적절한 멤버에 새 매개 변수 값을 지정합니다.

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

값 의미
SIF_DISABLENOSCROLL
 스크롤 막대의 새 매개 변수가 스크롤 막대를 불필요하게 만드는 경우 스크롤 막대를 제거하는 대신 사용하지 않도록 설정합니다.
SIF_PAGE
 스크롤 페이지를 lpsi가 가리키는 SCROLLINFO 구조체의 nPage 멤버에 지정된 값으로 설정합니다.
SIF_POS
 스크롤 위치를 lpsi가 가리키는 SCROLLINFO 구조체의 nPos 멤버에 지정된 값으로 설정합니다.
SIF_RANGE
 스크롤 범위를 lpsi가 가리키는 SCROLLINFO 구조체의 nMin 및 nMax 멤버에 지정된 값으로 설정합니다.

[in] redraw

형식: BOOL

스크롤 막대의 변경 내용을 반영하도록 스크롤 막대를 다시 그릴지 여부를 지정합니다. 이 매개 변수가 TRUE이면 스크롤 막대가 다시 그려지거나 다시 그려지지 않습니다.

반환 값

형식: int

반환 값은 스크롤 상자의 현재 위치입니다.

설명

SetScrollInfo 함수는 SCROLLINFO 구조체의 nPage 및 nPos 멤버에 지정된 값에 대한 범위 검사를 수행합니다. nPage 멤버는 값을 0에서 nMax - nMin +1로 지정해야 합니다. nPos 멤버는 nMin과 nMax - max( nPage– 1, 0) 사이의 값을 지정해야 합니다. 두 값이 범위를 벗어나면 함수는 범위 내에 있는 값으로 설정합니다.

fnBar 매개 변수가 SB_CTL hwnd 매개 변수로 지정된 창이 시스템 스크롤 막대 컨트롤이 아닌 경우 시스템은 SBM_SETSCROLLINFO 메시지를 창으로 보내 스크롤 막대 정보를 설정합니다(요청이 위치 또는 범위에만 해당되는 경우 시스템에서 메시지를 SBM_SETPOS 최적화하거나 SBM_SETRANGE 수 있음). 이렇게 하면 SetScrollInfo 가 스크롤 막대를 모방하는 사용자 지정 컨트롤에서 작동할 수 있습니다. 창이 SBM_SETSCROLLINFO (또는 최적화된 SBM_SETPOS 메시지 또는 SBM_SETRANGE 메시지를 처리하지 않으면 SetScrollInfo 함수가 실패합니다.

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

요구 사항

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

참고 항목

GetScrollInfo

참조

SCROLLINFO