SBM_SETSCROLLINFO сообщение

  • Статья

Сообщение SBM_SETSCROLLINFO отправляется для задания параметров полосы прокрутки.

Приложения не должны отправлять это сообщение напрямую. Вместо этого они должны использовать функцию SetScrollInfo . Окно получает это сообщение через функцию WindowProc . Приложения, реализующие пользовательский элемент управления полосой прокрутки, должны реагировать на эти сообщения для правильной работы функции SetScrollInfo .

Параметры

wParam

Указывает, перерисовка полосы прокрутки в соответствии с новой позицией поля прокрутки. Если этот параметр имеет значение TRUE, полоса прокрутки перерисовывается. Если имеет значение FALSE, полоса прокрутки не перерисовка не выполняется.

lParam

Указатель на структуру SCROLLINFO . Перед вызовом SetScrollInfo задайте для элемента cbSize структуры значение sizeof(SCROLLINFO), задайте элемент fMask , чтобы указать параметры для задания, и укажите новые значения параметров в соответствующих элементах.

Элемент fMask может иметь одно или несколько из следующих значений.

Значение Значение
SIF_DISABLENOSCROLL
 Отключает полосу прокрутки вместо ее удаления, если новые параметры полосы прокрутки делают полосу прокрутки ненужной.
SIF_PAGE
 Задает для страницы прокрутки значение, указанное в элементе nPage .
SIF_POS
 Задает для позиции прокрутки значение, указанное в элементе nPos .
SIF_RANGE
 Задает для диапазона прокрутки значение, указанное в элементах nMin и nMax .

Возвращаемое значение

Возвращаемое значение — это текущее положение поля прокрутки.

Комментарии

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

Требования

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

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

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

GetScrollInfo

SBM_GETSCROLLINFO

SCROLLINFO

SetScrollInfo