сообщение 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 битов данных о положении. Однако структура SCROLLINFO , используемая SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo и SetScrollInfo , предоставляет 32 бита данных о положении полосы прокрутки. Эти сообщения и функции можно использовать при обработке WM_HSCROLL или WM_VSCROLL сообщений для получения данных о положении 32-разрядной полосы прокрутки.

Чтобы получить 32-разрядную позицию поля прокрутки (большой палец) во время SB_THUMBTRACK кода запроса в WM_HSCROLL или WM_VSCROLL сообщении, отправьте SBM_GETSCROLLINFO со значением SIF_TRACKPOS в элементе fMask структуры SCROLLINFO . Сообщение возвращает позицию отслеживания поля прокрутки в элементе nTrackPos структуры SCROLLINFO . Это позволяет получить положение поля прокрутки по мере перемещения пользователя. Кроме того, для получения той же информации можно использовать функцию GetScrollInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo