Поделиться через


сообщение SBM_SETPOS

Сообщение SBM_SETPOS отправляется для установки положения поля прокрутки (большого пальца) и, при необходимости, перерисовки полосы прокрутки в соответствии с новым положением поля прокрутки.

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

Параметры

wParam

Указывает новое положение поля прокрутки. Он должен находиться в диапазоне прокрутки. Если этот параметр выходит за пределы диапазона прокрутки, значение округляется вверх или вниз до ближайшего допустимого значения.

lParam

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

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

ComCtl32.dll версии 5.0: если положение поля прокрутки изменилось, возвращаемым значением будет предыдущая позиция поля прокрутки; в противном случае значение равно нулю.

ComCtl32.dll версии 6.0: текущее положение поля прокрутки независимо от того, изменилось ли оно.

Комментарии

Если элемент управления полосой прокрутки перерисовывался при последующем вызове другой функции, полезно задать для параметра lParamзначение FALSE .

Требования

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

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

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

SBM_GETPOS

SBM_GETRANGE

SBM_SETRANGE

SBM_SETRANGEREDRAW